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Pr^aaisniilniq'/E^IJi 


What will you team from this book? 

LdokLaig 10 i^k-e your web 'rippli-cadcms beyond stodgy^ iiuo ihe 
Web 2.0 general ion? Il^rnf Fmt Rath Luke-s your |W Og] a tinifiiiig—iiaid 
producLL^iLy — to die max. Youll leani e^er^iliitig. frcmi die Rnidn- 
menials of RaiSts scaH'oIdii>g to bulldiiig cu^LomiseiJ iiuermive web 
al】iLsing Rails' tichu of vooh and ilie HV(" fnimeivoriL 

You. LB msi-stcr mtfT3 ， ftmE]js. ]ntrgi ;_iicm with Apnx : ， ]i[l X.ML. 

rich »tnl ^rni rlyiiiHiii^ grapliLiig tvt y^iir dnla... al] ill m 

of [hr fjmr il lakcn U> Innld |hf- s:3mr 3[]pH wilh , PI I I ：l , 
ASRNK l , l 5 t:rl. You'll i vrn ^c.i f<wnl<irl^lile ^nd wilh kLilTy'— 

but }tml'IL do il in [hr mtHti 1 %! fsd' b []rc]goiiimiiig ? not ^n^lheir iKwing 
wrsimi of s 1 IH_q, Worldr 
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Why doas this book look so different? 

We think your lime h taa valuable to spend struggling wlih iit-w 
CuE]tf[]ls_ I siitg ibe I^lIU'sL ti i 【 ]CDgilLdv^r stifiljct ^iild! l^rriing 

Lbeoiy Lo Ciaft m A iliLilti-sfiL^Qi'v k'HHiiin^ -rjtpfrfifilccH / Firm ti^tds 
usu 為 vis-ualty rich forirraL fur llie w^v wll]. buiii ~wo[ks，not a 

LdL-htwy H[ 3 |j>]'Q^ 4 ：h liilt pats ymi Lt> sl> ^p_ 
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Advance Praise for Head First Rails 

7/i iuf Fir.si Rfiih the inidLEiun of ilu r Hi j jcI Mrsi pmviclin 片 LiselViL i'< fc a[-w<irlcl in |i in nation 

u ； t'i ytm up liikI {|Liit kly L /AW Ffi.)t Rnils is an rxct'llmL Imk J“r pv< ^jU 1 l^arniiiin ； Ul.s ? iis wtl us 

liio^ brusliing lip oil Uie iatm features. 0 

一 Jeremy Durham, Web Developer 

I vvisili this hemfc wm^ oni when I tiing 仰 rie-d wiih Kail^ It wmild hnvv h 咖 er】hiinirnsHy:” 

_ Mike Ismail t Wd】Developer 


■I l"vr ihv I Icm\ Fim T1 k:). tin. 1 1 k>Ui icl riiLcLLiniihi^EJ 

— LuAnn Maj：za 


“Head First Rails is a great, broad intr*xliLcfioii to itrranve Weh 2,0 develnpmc'Til. This hook will fihov. yon 
htm f|uit k and piisy it is rlevHop rolnisu vvvhsitd 

— Malt Proud3 Sysicms Admirii^tralor and Dt*wli>per 

"Head First Raib is th«■ l>n"k I vvisli 1 had when I was tirsi learning Riiils. ll leads you through the essential 
things you need to ktiow in a lumiorous, iif>tni!^enst\ mannen"' 

— Eaimon Wakhe, Agile Coach 





Praise for Head First Ajax 


i-VjiiX h more than jiist revbhin 片 existing lerhnalogies, making some snvi][ changes lo yotn* web 
a]>plic^iti<>n and lht*n c.lt K i'luring il A^tx-fiifiljlt'tL RflM. lia walks Vin i [lima^h cill > ii Lhf 
step s ul buiklhi^ an Ajax applitatk)ii in I lend Fh^t Api.x, iind bilious yuu ilua Ajax is move ihiin 'that little 
ctsytiihinimoiis pan', hui ii i n■ tt<.?r appr^adi vvrb design all to^cthcL, 

— Anthony T* Iloldener III. autlior ol “.Ajax: Tlie Definitive Guide” 


"Ydii dnn'i jusl read H^ad Firsl h”s>ks. you Head First books. And it makeHMil ilie tliirtTnu.ep 

一 Pauline McNamara, Techno*pedagogical Consultant hr university 
eLearning project，，Switzerland 

“The author ckns ail excellent job teaching the various aspects n[ Aj^ix, bringing back previous lessons 
witlimr being rq>f-riti\T md iiuinduriii^comnmn probk nis in a way sh … hd]>^ rearfns ctisi ovn ihe 
]>n>blems ihemsHm In art 1 ms uheiv ihere slill isn’t a definilive prarli"、i lu 1 n -idrr is t^pued ⑴ all iht 1 
upLiem^ diiiti cincDLimj^ed lo inakt 1 up lib or Iwr own miml.” 

— Elaine Nelson, Website Designer 

“Behind tlu 1 Ajsix r\^hi hull? Oi out of the shadows with this boob. You’ll wrap your niinrf aioimd die 
core concepts, and have some fun in th^ process/ 1 

— Bear Web Applic^itioD^ Architect 


Praise for other HBad First books 


"]rrivivecl llie Uauk yesicrciisy and staried ki r^ad i amldn't stfip + This is delinilely ivrs ‘cool,’ It is 

iLlfK IhH llh'V Arr : A If si u! ‘uid lhc\ “iv ri^lil lo tlu 1 jjoiiiL T na rtMlIy inipivsHed/' 

— Erich Gamma, IBM Distinguished Ejigineer 3 and co-author of 

Design PatternrS 

“One of the funnirsi ;ind smartest books on software desijgn Fve ever read. H 

— Aaron LiiB^rge, VP T^cJuiology,. ESPN.com 

"Wlial used U 、 丨 m._ a lung trial mid (_nw 1(■iiniiny Iilih in w hivii reduced iicliiJ) into an ciigLigi 叫 

paperback, 

— Mike David 民 on ， CEO, News vine, Inc* 

HpniU desif^n is al ihf 1 cofp of evnT rh 叩 tn lirre，earh concept mnvevnrl with ec[ii;il doses of 
prajjiiiatisni imd wit: 

— Ken Goldstein，Executive Vice President, Disney Online 

"I V Head I 1 irst H 1ML wirli CSS & XH I i\LL—ii Eesubes y\m tm rything you m-cd lo h am in n lun 
routed* ibr mai. 

— Stilly Applln^ UI Designer iind Artist 

■_L si Lilly ulu'ii rduliiig throityjL li I n n tk < >r : ".title nu tlijsi^n Ill iiAW l< i- mmimmliy slick my^Jf 

in (hr e) r with ]mi lo make sure l 'vas attculiun. uilli \hh iamk. < >ckl as i( nia\ 

sf> li ncl, I his hook make^ learning nlxmi design patterns liui* 

"'Whil< 1 "ihiT h-nf^ks on patterns ar^ a spying 'BiiHiln. … Bm j tilrr,^ BuHtW. . / ihb hook is on lhc j 

docii bthiiig out %Siuikt： fr it up, b ； ibyJ'' 

— Erie Wuelder 

“j iih^ralK' l"vc this hauk r Iji lad, I kissc <| this lx]<_k in front mv vMt\' 

f T |i 

— Satish Kumar 




tid in m^njtsiy of my MothtT, Jr^m Rm y] {infllElis. 
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Author of Head First Rails 

pawd 命似办 s 3 



David Grii 11 i hs began programn^injr at age 12, aJtLT 
watching a docimientaiy on iJ^e work of Seymour Piipert. 

Ar age 1S he \wo\f ： an implenicnlation oi ivtperr s computer 

language LOGO, After studying Pur<* Mathematics a_ 

Universilv ； Iw 1 se^an wrkiny nde for romputers ⑴ id 
uiaga/ine unifies for hiuiuuis mi*.\ Jir is curreiiLJy、vurkbsg 
ami agile coac li in the L*K^ helping people to err ale 
simpler, more valmblc saltwaie. He spends his free time 
traveling with his lovely wife, Da mtl 
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liQ\V io use tlim koc 
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how to use this 


Who is this book for? 

【I vou can answer ''u s" in nil n! ihi sr: 

M 



Are you comfortable with HTML? 



Do you have some experience of a computer language 
like Java, C# or PHP? 



Do you want to build cool stuff for the web in a fraction 
of the time it used to take? 


ill is hnok is ksr 


Who should probably back away from this book? 

U you Lan LinsutT “vtvC miv ol tlm-: 

/ 4 w 


o 

o 


Are you someone who doesn't have any experience 
with HTML? 

Are you an accomplished Rails developer looking for 
n reference book? 



Are you afraid to try something different? Would you 
rather have a root canal than mix strspes with plafd? 

Do you believe a technical book can’t be serious if it 
anthropomorphizes clients and servers? 


ihLs hook is iiol \hv vou 

'¥ 



晷 。 w ihis book is 

+or any 咐 wiih a J 


|f tlois is the d 挪’七 

worr^ fide ttcad Fi^rst 

HTML M CS£ ( )<rtTML by 

Elisabeth Frecniaft ^4 E〆 ■亡 

*preew3Ri h^tk 

"to 七 Kis bock 
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f/te 


We know what you Ye thinking 


How cmi Ifiu he a siiious Rails l>oofc?’’ 
'VMiiit's K\ ith all lIk p gritpliit 、 〆’ 

■Can I ciL'IiKiklh fmrt? il this- uliv?'' 


% 


We know what your brain is thinking 

Vsjirr Infill mtvcs U\ ;t]n r ;iys stMrriiin^ sr：mnin^ nwtni^ “ ir sonirlhir 

umisiiL 丄 U m I mill that \\n\\ Lind it ttrips \u\\ sLiv :ilive. 

m ■* f W # 

So wliM doi ^ viy\\r hniiii du wiih liII lhr ruulhie, NixItE^in; mirmal things y"ii 
momiiter? ]%\Tnihmg h tvr} In slop them fVom initrfaring with the brain s 
ji il> rrn ： irrlivig I hint's. \\va\ mfifttT. ]t Hi icsn's hs \ihvv ihr borintf 

l]lin^s; [\w\ nt'VtT m;kkt fc il ]j-isE iUt' “ihis is if ui^K ]i "1 iniporliml" l\\U'V. 

H"u. tlocs yoLir hrmn know \vi]at + s biipnrtam? Snppos,^ you’j'e out Jor a 
clay hikr a nr! a u^t jumps in iir>m of ymi, whm hnppiis insirlf yoiir ht. i acl 
and l)oc v? 

Neui^om fire, Eniolions crmxk tip Chemka/s sut^e. 

And [hat's htiw vmir I m nin knows … 

This must be important! Don f t forget it! 

But im^no yoirte at homej or in a library. li\ a safe, warm, tiger-tree zemt 
\buVt; ^uscK iiiii， ( icnin^ icacly ibi ail exam. Or uyiiig It-arn mi« j iniigh 
I clinical lopic ynnr bosK tliinks 'vill i-ikr ^ week, len days ai the nn nil, 

Just unr prol>lriii. Your trying to do yean L i \n*i fim ll's li yin^ 

mate sure that this obvkmh tion-important content doesn’t clutter up 
resources, Reraiirces that aie better spent storing the really hig tilings 

dgn' l ike ihe dan 『 of im\ Like the wiimcrs of the last ihiee 
seasons o| .\incrir：'LTi [dtij. AtkI thm’s 11" siinph 1 avw L 。 Irl] yc mr 
bi;dru ,fc H^y I imii“ thmik you 'vry miU'lij but no uiaucr lu\\\ dull 
\hh is. arid ho\v r lililv ['in re^i&trring m\ the emotional] Rkhtrr 
【ilr rigbi nou; I rmlly th wanl you lo kvcp ihb stufl' ar^uiKl/' 


Z ^ ir[ 
11 
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how to use this 



融 of a ilead RrsT reader ^ a ^ 


aketo jearn something? First, you 
t irsnot about pushing facts mtc 
i cognitive science* neurobiology* 
lot more than text on a page. We k 

First leartiing principles: 


mm ㈣㈣ 刪 — 

within or ^ graphics they relate to. : 

w on an0 th e r Pa g^nd I 一•即 _ 的 

elated to the coment. 

afirtita , an< | personalized style. In 

r s ^=d_ e d UP to . be« e _ posHearmng teM 
d ； rectl , to the 阳机 usmg . 邮印抓叫 ccnversa^na 
f orma l tone Tell stories instead of lectu^ng- 

. WM 如。鄉一 ⑽ 

, at ing dinner party companion, or a W * 

n — 沖 deeaW- In other words, unless you activ 
■ t :g 二 happens in yourJ^ead 

provoking question and act_ e 

and multiple senses, 

rea 邮 , s a « 抑州 _ we 

s Q ne experience-VaurbT,in Pa y 5 m__i= 

喷 eye - 咖 _ u ㈣ P 扣以 Learning a 
,, lhjnII l^arn much mof'B __ 


Test DRive 
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the 


Metacognition; thinking about thinking 

II' v"u roallv \mnr t" k ； irn. and \mi vvs^nt tn km mow unk klv iiitcl mmv 

■ # I. r 

d^s.-plv, i 〕 f]y aHrnlion iu how you pay 謙 ndun ， Think ah<mt lim 、yai i ihink, 

I vt?arn how you karn + 

tA tis did ti"t mke cuur ㈣ on ni[ “ic 嗜 liibn "i Ic ； tilling Ih … ty u In ti wv 
were growing up. W c were ^xperkd to learn, hut rarelv (mght to leaxii. 



r wonder how 
I can trick my brain 
into remembering 
thi^ stuff … 


O 



So just how DO you get your brern to treat Rails like 
it was a hungry tiger? 

II lilt 1 stow, l&d iulis wav. or tlie fcistci; mure SSecttve wav The 


Enl wt- assume *Jmt li h riding this h"nk. vmi l eallv vv:»ni io niiistcr R“ik 

And y(]u iba!>l) want Ka spend a lot of rime. If ymi want in \ {$i what 

you read iii this b<»ok^ vrui ncrrE to rn^tivhrf whal you iTacl + And for that* v^ouVe 

r ^ f t iff 

irol Uy el r [" list 1 musi Iroin iliis i>osjk, or ft nr hsKik or Inmiiiy 

exiJtrrii iiL'c, Liikr ivs]x ， nsiJ)ilUy Ibr y"ur brain. Yotir brain an (hi^ cunt^nl. 


V\w hirk is to ^p[ vnxir biMin in ihe m k \\ niMierisil yi ： iuV^* 1( ■: vrninu. [is 
Impoi tiuiL Cfucial io your well-lj^in^. As hiiporLmt a tiger. 

(}Ltn u nvisc 1 ynti'i-c in Ini- a r-onstiun l>tiLlk\ with ynur bi Hiu doiiiy ils brs! 
U y keep the tiew r contciit isom stk'king. 


slow way ia about sheer repetition, itou obvioiisJv ki N av that you me able to 1mm 
and raii^mhi i vykjx thr ： <lulir^ ol' topics ii' yn" h-vp puiintling rhr samr (hing jiHo y"ur 
brain, VVidi i L noi3g-h I'c-peiitii m, y< iui hjain Iliis luni. hm he 

keeps looking at the ?ame ihin^ gtw and o；rr and so I suppose it musi 1 兄 /’ 


Jlie iastrr w^y K lo dn anything thnt increases hraitt uciivity ? cspectiilly dillemu 
types of hr,i\n arth-ity. Hie things un the prrvi"w page ami Insr p^h of (he s"3iuinn ， 
and they’re all thin 取 that U<iw pirsven to lw\p ymir hvam v\>：n k in your Fnr 
tfXiuijple,. slLidit*s show ihiit puUinq; woitls within llu fc pit tutu liicy [Itn.ihe ( 郎 opjX.ised lo 
Somewhere.' else in th^ page% like a caption ur in (Jit ： I^lkIv text) causes yout Ijrain lu try to 
inakr^i ^ of how 7 Llir \mn]s t nu\ piclinr a elaU% aiul this causes mmv ncui'nns tn lur, 
Moi'e nnu uhk fli'hig = mim 1 chances brain u f grt ihru this is sruTvethingwnnl] 

paying ^tcntion to. and possibly recording 


A con\ ci^aiLc ： 3iial style helps because people tend lo pay more aitention when they 
peirdve \ ]vm ihey^re hi a <'( iiv^TsvMiiUk since ihey’iv exj^ctt^I ui iilrmg' anrl Im iki u]> 

lhx j ii i_ ru【_ Tht k aiwing thing is ， youx braiji doesn’t n^'^ssRrsJy i /ur th^it ihe et coii\^rNation v 
]> brlurr-n yuii [tnt\ a Ixmk! ( >ti 11 h 1 ulliff if l|it: Vvi'iEiii^ style is Inn rial jlikI d v\\ yusii 

brain pnccivus it iJk 1 mTiu way yuu fXperienit 1 bi'ing lecliiiL'd to wliile siuing ill a roomful 
[jf passive attendeeii. No need to stay a\Vi ： tke, 

Bill pirUu.es ‘uid romvrsiuiimd sl\ lr ar^ jt_Hl liu. I . 
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how to use this ) > 


Here's what WE did: 

We used pictures, because your brain is tuned lor visuals，aot text. As tar as y :]ur 
bra in CDiicemed, a pic lure really is vvorj h a thousand words, Anri when text and 
pirHires work lo^etherj, wp emht ddRrl the text jw the pimires your lirain works 

iiinrf' ^flL-tiivflx wim Lht 1 ipxe is within the iliing i]ir U j xl r^JVrs lc》 5 iis op[x>H( j d ht in a 
capLioii i>r biiried in the texi somewhere. 

\\r. used i^dundancy^ saying ihe same (hin^ in diffhm/ ways and wilh diil^jTni media Lvp^s, 
and mufftpU Ui iiiLT^a^ liie chmu t^ l\mi the contt'iiL j^els c<jtled inlu rnm.t- Limn one iirea 



of vcjur bram. 

♦ 

We cont'epls and piemr^s in unexpected ways hemiise ynur Imtin is [Lined for lusveky 
mid vw usijil piciures and idua^ U'iLh al luasL som{ J emotional bt h cauai , your bmiii 

is tiuicd to pay atiemion to \hc biodicmisii y ol emotions. I bat which muses you toJh } f 
something more likely to be remcniberecl even il' that leding is nothing more than a little 

humor, sjirprise^ di' interest, 

Ut ns^d a pei^ iiializecL conversational styles because your brain ii> rimed En pay move 
attention when it belie\cfi you ie in a conversation than if it thinks yoiriT pa^ivcly listening 
to a pre^ntation. Youv brain does this even when you’re rmdhig. 



We incluried more than RO activities, because your brain is runec! to learn imd remember 
more wl^n you da [hings than wJien you rmd about ihings- And we made ihe exercises 
rhalIenfTing-ye ： t-do^ h\ f^ l^rau^e Uiat s whal mnsl people prefer 

We med multipte learning styles, bwause jiwi ： might pie(i fc r sc^p-l>y-5Uep procedures, 
while som^onr Hse wants to undersiaiicl the big pk'tun' firsl, and s-omeoju* t'Ue jiisi w:-i_its [o 
sw an excimple, Rui regiirdless oi' ynuir own learning prelV'iTiire^ b^n^lits Imm serinitr 

ihv content represented in multiple wiiys. 

\\V inrkrlf' ronienf Ibr both sides of your bruin' l^erauK^ ihe nicire oT your hrLiin you 

Lht- more likely you are io learn vmd rt fc n3eml>tfr and \U^ v<ui mlay [ocust j d. 

Since working one skle <_f tlie brain often mfims giving the other side a tts rest, you 

can be more productive ai learning for a longer period ol tijiic. 

Ails.! \\-v included stories and exrrcisu thiti presem more than one point of mew^ 
brcause your brain h tuned u> learn more tk^-ply wlm ifs forced xo make (valuaiiom and 
judgments. 

Wc ijiclutled ehalleng^s, uilh exrrcm^, and by asking questions that don't always have 
a striiiglit ansvwi ； because ym\r brain is Limed to learn and rL-mcmbcr when il has io imrk at 
ramethiug. Think about it — you can't get >^ur bodv in sha|>e jiist by w^khmg people ai the 
pym, Bui ue did ourbesi to make sure that when vois it workin g hard, ^ on the right tiling 
Thai you W not spending one extra dendrite pnii.e^shig :i liard-tt5-LLi identand i'x^rn]^lf\ 
i.h j parsing dilliLulu jargon-1 adci^ or uVL j rly terif lexi, 

Wt 1 im*d peop/e.fn slorirs^ examples, jii<'lures, bermisf% vvrEI, li^craiLse 卿 Vf a pers(>n B 

And yoav brain ptiys more aUeiiLkin to peupb tlmn it dties to things. 
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Here's what YOU caw do to bend 
your brain into submission 

So,, we did niu' part. The is up to yt ， u, Theae tips are a 
stalling poim; Iktrn t" your hraiM aiid ligun 1 r^n whM u r r»rks 
lor yon and what dbesn 1 ， IVv new 
{hii otii and %btk if 


the 



O Slow down # Jh0 m(&r« you und«rst^nd t the 
less you have to memorize. 

Den r ju^il imd- Stop and this^L When 1 1 lwok asks 
ymi a question, dan'l just skip to ihe answer，Imagine 
lli: 丄 L sunu’i nit i^uliy is ^Liking tht 1 citLi'siiou- Tlu_ 
more do pi} ynli Q.nxv v-our hraiii tn Lliuik.. ilk* brUrr 
o y"u have n( and mricmbu iig. 

Do the exercises. Write your own note&. 

We pur them iii- hu\ if we did them tor you, that 
would he like having somroiie else* dn yoin w ^rkonis 
foi you„ Aiul i\u\i \ ]us[ hok M the 【mx isn Use a 
pencil. I luTt’s pk iity of evidmur dial physicaJ 
iu livi” a-Mf k ai niny ( nil him-aw tlit- riling 

Read the u There are No Dumb Questions" 

That mean^ iill of ihm They it not optional 
sidrh;ir^, + tht^y part of fAi? care content! 

Don't skip llieitl. 


fQl Drink water. Lots of it. 

\rptir liniin u.r 卜 rkh l>esi In ;i 11 ire Ixilji \A IliiKl. 
Dchydi ritioii (which can happen bufoi r you mr 
iccl thirsty) ck-ci tcjgiikivf function. 

❹ Listen to your braim 

l^iy iiltentiun to ulictiler your lu'id" b 炉 lit 叹 
nv^Hnaded, li ymi find yourself starting to f^kim 
tho surlhre "r imgc[ wha 【 y< t\\ jnst il > lime 
[iir vi hmik. ( >nc e yot] i^o prisi u i rrlsiin fK>inK ym\ 

Ui n l'i Umi ii fasU^r \)\ in iiiLi to shove iimix K iii, aiatl 

』 ^ ~ 

you might own hurl tlir process. 

0 Feel something. 

Your brciii^ needs m know tlm lliis matters. G(_.l 
hivd' rtl with tlie sttsries. Mitki up youi J u\vn 
options for the photos. (JnMiiii 增 over a bad jokt" 
is stiif b^iler rhan feeling nothing ai all, 


0 Make this the la&t thing you read before bed. 
Or at least the last challensins thing. 

Ihwi t>f \hv It-an 1 iiij^ {< k spi 1 lvaII) iticr Imnsicr to 
loB^-Lcnn menu n-y) Siiippciis qfhi'y\、w put 1 lie t)Onk 
dnuai. Yuui hram needs dine on'm nvvn, to d(i iii[>re 
prurc^ing. If you pm in something nt w during \\\M 
[>riji'essin^ \ 'mu\ snrne of vvhal you jusi If^irn^d will 
be lost. 

o Talk about it_ Out loud. 

S]xakin^ actrwiicii a diilei^iU pciri ol ihe l) 【 aiii. If 
ytm'ie trying t< y mKltTstend someilihig. or inerrase 
yawv rliLtm，e d R-mcmlMTinp,' it lalri; say it "vit ImicU 
Roller Hlilh try explsiin it mil loud Lo sarn^onr eke, 

\ ■ siill learn nv ire quic k|v, ;i3iti you niiylit Liiiruver 
kk.iis \AMi liLtdii'l ki u iwu Ui-ro ihcrv when vmi 

Jl M 

l eading i^bout it. 


O Practice writing Rails applications] 

L hrscV <]iilv 01 a: wav I" iriilv m^stcT Kails 

uri Ha 1 

prE^gn mi tiling program Rails applications, 

/Viid ihat' , s whai yonVe g-oiiig to do flimiighnui tfiis 
hod His - lit 1 hi \v:iV lei LmcItT^hincI a Mtl na i is 1^ 
doing it. ^Atliviiy sirriigilu 卜 11 s \\w iirund 
so wii’i.t; ^oiiig to give, you a 1*1 tA pi^K titr: ewry 
rliapLoi has apps (h^L 'vr’il huikL Sr> dr ml jusi skip 
(>ver iliem — kn of IcMniiug Ji;jppcns w hen you 
hu\h\ 1 ht"sr u)sytmrsd And dnn'E woitv if ym\ 
nictk-i 1 misliikt's, \\yuy Inin :u_m:iih lean^ morr 

if 

C|iiirkiy fnmi uii^Liikcs ihaji il dm，s from suri £，sn 
l ; inall\; mEike sure you iindei^tiuid wliat’s going an 
Ijefbre mov ing 011 i;o the next part the hook. Ead 
t hnptei UiiJcImn the dmpiers \hm con if bi-lbre it P 


you ar& nere 
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how to use this 


Read Me 

'Vhk b a k ;t] ]iitig expori« ； iire, not a idtmn book. UV deliberately stripped out 
cv( fc niliin ^； \ Um tuiglii gt r in ihe wwy ui learning ui iait^r b wt’re \vui_kii 屯 an 
that \nn\n in vht. h >ok. And ihr [irni timt you nc^d ir 3 Ix^in as \hv hi firming 

brtMitsi 1 Uir 1 Mink imke 、 iissLimplKm^ mIj-oliI wlml ycm'vr【ilnwiy sm! iind Iranu fc cl, 

Before you begin this book you will need to get Ruby on Rails 
installed on your machine. 

riiin is noi hook* sn \\c dnn ! have :vny i lKipi( j rs (lint give \tjii instnsrtions 

^ m luiw h> hiHiiidj kti! ly i m lUk oti your mmpulei: h s tn-'lEtT iu gK lh;tE !ii】id or 
inJurtnaiion from the wv\l Ydu will tut?d td Rul a rm Rails wrsinii 2,1 or abriv^. 

.十 

. 1 ^ well as S( )Lkr 3. You atii find tm\ nmre Irom 
http ： //www. rubyonrails . org/down 

This is not a reference book_ 

So doiV r . cxpticL to ^i：v tots uikI hits of pageti explaining 15 dHTerent ways to do 
sonn/thii'i!^ H Wiuil you to understand by duing, sn riglit Imm thr gOgo, 
give, yi iu just enongli inlbi mation in mo\^ your learning Ei jrwnrd, By ilic end oi liie 
book, you will have a mental framework of how Rails works and what it can do + You 
will i3ir L n \ n J - : 山 Uj sl"t the rrlhmire eti^u riiil iniu vour hrain nuirh rncnv rnpidly 
, ii m I 】 in ， :mi 叫 「『Lilly llian you wtnilcl Iuiv<■ Ihv]] ,ihl< b io Ejefnrc, Psyt l^sloiris^ r;“l iliis i\iv 
abilitv Uy chunk iiiioriiKal eoji. 

ji 


AH of the code in this book is available on the Head First site. 

\Wl\ pwnt «ilt of ihr rode ymi ll ruvfl as i Ie"s a good idea u f pn_gr:nii 

wtih llit* I look, ;iii(l iTs a great idea tn p!;n iiiouiul with [lie t mul iiutke 
it sJm \'our n'vii (Jiin^. Lkit scjur 1 times \v.iu tmtv waiil a ram m! ihv tndi' u^ tl in riiuh 
rhaplri' \u'\t inatlr it ^ivaiJiiblo []■] the Hrad Hi 4 \v<■!> \iie, Rn \h iipplicatkhns 

^»re sdl-om(alned, llicrf V tvay tn why you i：Ant lutve ihe that cIcm s 
\\ U\n the hook .wvj it should dn, iilongsidr your nwn buifed and pimped out versirm. 
You vm] df>wnf< jar! thc a rocl^ Irnm 

http : / /www^headfirstlabs . com/books/hf rails 

We don’t fully explain every piece of code. 

Rails cim grntTal.e a lot of codt 1 fhr y«u h and \\ ? v don't wmU you Lo gpl dtjwn 

in liiK'-liV-inu 1 d^scrijjl h> ns. Wr’II llir iii3p< friaiH pcirb iJiuL you "mf Ui km \\\\ 

iiiid tlK'Ei we'll iiif-i'v oil Yhmi \von v y— hy the t ncl oi Lhi- book, ,ii! ui Llie pieces 
sliDuld lall into place. 
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This is a Rails book, not a Ruby book. 


Ruin is thr Lh;iL ilw Rlu 1> IrHiiicwi »rk is uriUiMi in, aiid uv’II Umh 

ytHL \m{ riiuuyli Ruby as. go slicing, DuiA wtury U y"u hnw jiiic 
experience of another programming language like C# ar Java, you’ll do just 
line. Riiils is suvh n system ihiit \tiii « an a very hsig way whii 

ins! i\ lilllr kub\ 

The activities are NOT optional. 

Tlie cxi ： \xht^ and aciK il ies m nm ^kIcI^ they re pan _1 r v t-nre 
content ol" the hnok. of !hem ⑴ t 1() hr lp with mrmoi); srmn 1 U ir 

miftiTsLanding and somf will help vc m ji|ip|y wlial ymtX^ learned^ Df>n"i skip 
ihc ex^R'iscs. 

The redundancy is inleittional and important, 

(>i w clislinri tliili iciu r in a l If ad First liaok h 【 hat'mill y"u t" i^；aJly i^ct 
tt. Mid vve want you to finish the book inncnibering what youVe l「:u n( <l, 
Mosi rdi'mu:t? lx_r>ks doivi. ha\e rctmtion and recall as a goal, l>m ihifi Ixiok 
is ahavEi yniflt s" - "i_ (lir L'nnrepis mme up mun 

We don’t show all the code all the time. 

f hit iieackTfe ndl us iliat ifs rating 1.0 w m\c through 10 slightly tliflcrcm 
version!- nl' thv -a me \ ^cv nf wdr,、■>wc will uiily >h< ]w I he psirr^ 
of a script th^t lia'e changed. 

The chapters are skills-based not technology-basedii 

Kiich ch ； ipk-T will give wn t \w skills tn write tuotc. : -md m^n r advanced Enid 
vsiliiuble applk'iiiii^is. S>" uv d“i].l Jiavt 1 i luiplrrs [lull ji.tsE deal witli 1:.illdi'u 
to datab 划 dor designing a pretty mterlhcc. Instead^ every cliapu-r tm lu s 
vnti a Hltlc alnmf rhe dil. ； ibasc, a liirlc iilnut llie inti ； rlacr, and a Uitlr abnm 
several mher pa:ris i>f kails, Hy ihe end oi tw h om\ ymi’II be able in sa>; 
“CnH now I can build apps that cfih do X, ' 
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水 Really Rapid Rails 伞 



Want to get your web app development off to a flying 

start? Then you need to know Rails Rails is the coolest and quickest 
development framework in town, allowing you to develop fully functional 
web apps quicker than you ever thought possible Getting started is simple; 
all you need to do is install Rails r and start turning the pages. Before you 
know it r you’ll be miles ahead o! the competition. 








ive/come to 


Friday, 9 AM 


The fir^t email yi>u open is from an old friend in Eronhle: 


:：:: U ^Remember that === 二 、二 s! 
were working on? its not going well. We ve been worning 

J\\e team is having real problems, 

Do you think you could create the application for us. 

We need a web site that can: 

List all sold tickets 
Create a new ticket sale 
Read and display a single ticket 
Update the details of a sale 

Delete a ticket sale that +k e 

二：：二 = S 二："二 _ _ 

argue with! Here's the data structure. 

Ticket: 

narne - nam© of purchaser (string) 
seatjd^seq - the seat number e g. E14 (string) 
address - address of purchaser (long string) 
price.paid - sales price of ticket (decimal) 
emaiUddress - email of purchaser (string) 

,We attached sketche ； of the pages too so ^ 

Oh - and we need all of this for Monday or my buttes on tha !me. P* 


The system is designi d ro be used by fninl-ol-houF：^ stall m ihe conm t 
arena* The datalsiLse will he resf [ lor fiiHi ronc^rt, so il will finlv need 

w 4 

Icj record Ltie dt-Uiik Tor um' cimt erl al a Limt\ Think you cm\ hHp? 
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I jta 掴 ■“Lll L _ • 



wi 


The application needs to do lots of things 

l lviv ^n：< K [lie skrldieH o! the p 哗 ， s. \ low tin they ill in \\iiU the sy^lciii 
iTCjuiiviiinih? 



well 

limk^ {h 

， ■ 矽 I 

bt 

the dc 
七 tdeet 




1a# 



. lfl 

々 f’ay ‘ d^ih 
a sih gfe bekei 




J ^ are 

Will be 





as a 
ttt will be ^ 
link 七 hat Mh 
1 to 

giU J a 


憂 9 臀私 M 


What types of software will you need to build and run the application? 


cd 』 

hew 
^ i 

H b w 

w tf w 

¥lb6 

.iuvc 

o a a 

c 1 — s 


you are here ► 


3 












































































know your 




So what things do we need for the app? 

Ilw ar*" ivrcl iu rim ilie a|)piir；ilifjn i iti she 

s£ fc rvrr. iu a t s d: 


o 



An applrcation framework r 

\\\' iH^ecI a st' [ of pi'^-u ri Ei^n. forlr tu \ hi-si will form il_r loimxlalinn a! 
the web appIicalKnu 

A database system. 

WV iutcJ : sniuc Mori <il thiuihas^ u line wr cim sturt * 11 it 1 tlata. 


❹ 


❹ 


A web server. 

We ncod ^omculierc tu t un ihv wd) a]5plicatiDii. 

An object-relational mapping library. 

To simplify actress to Lhtf diiiahasG mnsi weh appIk aLimis now use liii 
< )R. librai'y lo t'ouvt'tt die dataljas^ rfcord^ into uljj^ct^. 

The 0 ■尺 






心办 t 






a?? 




URL- 





rU.- 


J\\t is ihc vcl& ^ vcr 



T hc ^ a pp or 

^ 桃 b server 


So how does Rails help us? 







认 ere 如沾 、 ht{ ^ 
The 3fF r « ads 

yn-itcs ^ 


Ri ! i[ardU'ss r ii' ]s：ii Lnijrua^ you rode，itu ) ■ u ill 】)mkibty si ill 
m rd ilirsc vhivv lliii 阶 1W youv tkplwcJ jppIkiLLkm. ()ur i A tlu ， 
en.vit thin^H alxmt K：iils is iliat il o n^liiins thr salhvan：- ynu 

will iieeirl ali h w ndled in Jorfree^ 


Let’s see how this works. 
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Poo] Pu^^Je 



There are many features burft m to Rails, Your job 
is to que^s which of the features in the pool 
we need for the web app and then place 
them in the blank lines below. You won t 
need all ot the features. 






Note: each thing from 
the poot can only be 
used once! 


Bundled ennaiJer 


SQLite3 RDBMS 


Bund Jed HTTP server 


fletionPack fra 


REST-based services 




Serve r-sid^ graphics 
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data-driven 


Rails is for database-centric apps 
like the ticket sales system 

A lot of appliLiidana liave a at the heart of them. TJir mail] 

reason these application exi^B so that users tan access iind modify 
rhe ron I nits r»i，lie ckitrilKis^ iMfithout using SQj，dbdy: 

So \vlm( an ： the | ： rol)Jeim dud need to be hoIvlxI when yon ccmnect a 
dat^ba^ to a well application? 

WrIL I ho wi'b appJkalian will [u ed t。allow tlu- user h i access rtiicl 
mn<lily d-i^u R;dls lea an application framework cullrd [hv 
Action Pack th；n will help you 职 nmk clam-driven，inlmtive | ， wh. 

S( 'a hkIK; uri i appli( ； atinn：s m.xxl !f » hr run “eui web server to display 
llicse p ； iges f so Riiils comes w\ih one built m, 

I hirtily, you n<X'd ±\ datable. Rails errak 、 i_pplii ntioiis [hui are 
ronfi^uri；d lo woik with an intcgiYitecl SQLite3 dauibase. 

Ilir fbinli tiling you nevd is : ku t>bj^ct-rcliitiunal mapping 
library im<E RsilIn, pin>\ide> mtr t iillcd AcliveRecord, l iw^ makt i> 
your database k_"k likea collect io]i of simple- Ri^br ohjtrh. 

As u'rll as all this— Ralls also includes ii pilr n( tool scripts to help you 
manage the application* So if you are creating a database-ceruric web 
application yoifll lind that 

Rails ^ives you everything you need* 


Action Pack frarnework 


Bundled HTTP server 




5QLite3 RDBMS 


AaiveRecord library 

e a 4 ^ - < k n § j a ^ a j ^ § j 4. ^ i§ j j . <b H 1 



二 r±? 产 



Poa] Puzz]e 

Solution 


There are n^any features 
built in to Raik. Your 
job is to find the three 
features in the poo! that we 
need for the web app and place 
them in the blank lines below* 

You won't need atl of the features. 





Raik ^ ^ a, ' ^ csc *. 


Testing fram 


Bundled emaNer 


ework 


^rv^r-sid^ graphics 


REST-b^secf 5ervke^ 
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You create a new application with 
the rails command 


So how do you get started with Rails? 

Creating li new web application is actually really simple m Raik 
All you nertl io du is open up n ⑴ mmarul piTimpl nr h t niitial 
^vindim, :ind lype in rails tickets, where ： ticket's h thp name 
£jf tht 3 i.|)pli(.'alioii you waul tn 



I Filg Sdit Window Help Rg lsRu^s 


> rails tickets 


at a com^d 


So what does this do? 

Typing rails tickets cleverly g^nefatt-s a w^b 
applica ion in a new tblder called “tickets’■ Not (mJy llinu 
within the tickets tbldiT, RaLb generates a uliolc* host of 
other ibiders ;mcl files i\vw form die basic stmcnirt" of a 
ut^v ^pplkation, 

Thk mrans dim ycm've HIWuhviy mraird an riijire basil 
wh applir;jiion with just one sh< M't t nmmanrl. 


n 


Riiils gcnerat^& : 

a lot of files and ； 

folders, but f 

don’t worry- - 

■¥ 
* 

_ -fa 

；They're all there for a reason，and ； 

: vi>u ll imrliTsiiinr! nhai Uipv iill du hv 

■ -r ^ #- ■ 

_ ■ 

* the t a ncl of ilif IjiksL : 




tickets 


A 

gaib generates a ^Mo\t / 

suite ^ ^tles 3nd ^o\dtn 

(ov y&u ‘故 just 
domma^di TWi is ihe 

^ ai% <：ri ^ c 

vet a〒f 


-> 

i 

README 


圍 

Raksflie 

p —^ 

C 3 

app 


i 

config 


U 

db 


□ 

doc 

- > 

麵 

lib 


:二」 

log 


□ 

public 



script 


□ 

test 


i:i 

tmp 
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圈 

vendor 











test rfr/ve 




Tesr Driws 


Becansf 1 the application you have just created is a web a|^pliration, 
you will iwvd Lo sUirt i\u M lHiiU-Iu ut j b strvtT Lu ^vv it rumiing: 

Ai aomiwmd prompt or tmnhial, rhange inio the tick^is fnldn 
and type ruby script/server. 


谷。 Mn ■b> i^e 

心 Id 找 f 沐铋 e E 出 t VVIfidO^ Help 

/7 

“dtid sHbart thff 
web server- 


J\xt% h t^c toftwk^ ^ct 

^ ^ via a 

/ ^ a ter ，』 咖 

/ eitiicr ^ a 



A few messages will appear on the screen that will confirm die 
web server k mnniiig, Wm you can see the ck fkuk home page by 
opening a browser at: 


http://localhost : 3000/ 



TK 以如七 

web sw 吧 . 



Rails starts its web server on port 3000 
by default. It you want to use another 
port, such as 8000, run 


ruby script/server -p 8000 













getting 



Now you need to add your owm code 
to the default app 

Riiils llie hasir fitructuiv (si your app I'nmi ihi* get-gn, bin 

you s(iEJ tired in uc !d i| it k t ； (Kh ! il^il h siK'riiK' lo wtui( you w*niE a 
Ever) Ih dy'^ appliL'aLii ui is diflirciit, IhH clm.s Riiils lhi\v anv UjoIs or 

tricks that make it mski liir vnu tea cixatL 1 cuslum rudt? 

■ 

Well actLL.Llk: [i hKh'h. Did vcm n^jtice how Rails treated a \vht)lr 11 Ir 

J - j 

structure for you ? almost m il i[ knew what you were going to noed? 
That’s because Raik app^ follow very strong naming c^mviidotis. 

Rails apps always follow eowventioHS 

All R 他 ； ippikatiom fWllmv shr satm- basic lilt- snm uirr anrl use■ 
consistent nnmes |«jr t!iinp;su This makes \hc iwitr 

Uj undeistimd, but it ciisti meaiB tiuil tht. Imill-in Rails u n ils will 
U]ids.T^iri.iul Jii i、v yuur ap]jlii dilitm vvtjrks. 

So why is thm i.mp«\\V!I if the tools kiK:_w how v<mr app 
is sin“ Uird Mm ran UHt* llirm Lo allLozn^iU 3 a Ei ul thr rinliny 
tusk-,, riias ua\; Rails uu ^onwnULins tu gmtTattr code For toiu 
vv itlion! yr.iti liisvin^ U) r< niiisjiiR' your uvh applkniKui- l]i cvtlm 
w>rds. \{ t \\h Ji hllows com^ention over co^ifigttration 

Let’s look at one of Rails most powerful tools: 
scaffolding^ 


Kails principle 



Convention 

Over 


Conf ig uration 


tli©rei£ire n9 

Dumb Questions 


O: You keep talking about Ruby and 
Rails, Wtiafs Hie difference? 

Ruby is a programming language. Rails 
is a collection of Ruby script. So the web 
server, lh$ Action Pack application framework, 
and the bundled tool scripts are all just Ruby 
scripts … snd therefore, part of Rails. 

How do t edit the front page of my 
new website? 


That HTML file in the pub lie/ 

index. httnl file below 細 application 
directory. The public directory contains all 
the static content for the application, 


O : What if I 


want to use a different 


web server? Can f do that? 


/\^lt makes sense to use the bundled 
server while you're developing. If you want 
to deploy the live version of yom application 
to another web server, you can. 


0 ： Does it matter which folder I m rn 
when 1 run ruby script/server? 

Yes, sure does, You need to be in ihe 
folder containing your web application 


Qj What is it that compiles my code? 


Ruby ban interpreted Isnguage, 
like JavaScript. That means there is no 
compilation necessary. You can just change 
your code, and immediately run it. 


you are here ► 
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generate 


Scaffoldihg is ^ENERATEP code 

So vvhal r rur appIiration n^^rl to do? Uiok al 

dial email again ： — __ - _ - ~ - ~~ - 




TKtS is -blC 

be( orc- 


Tk 

need -to aei 

on thii 七 idcrt 
sfctMd'tuirc 


were working on? It's not going well We ve been wor y 
The team is having real problems, 

SH 1 _- ^hLk 


The team is having real p 「 w _ 训 m 

Do you think you could create the application 

■ a iL,_ * m . — 


-,(Js ― 次 ' 

tr 二一 




_ 


_ 


Ust all sold tickets 
Create a new ticket sale 
Read and display a singie ticket 

_ Update the details of a sale 

、_• Delete a ticket sale 
argue with! - 



: et: 



name - name of purchaser (string) 
seat Jd.seq - the seat number e g* E14 (string) 
address-address of purchaser (long string) 


prlce^paid - sales price of ticket (decimal) 


address - email ⑶ . 

二:二 ： a . 


So we need to create web pages dial allow ii^ to Create. Read. 
Update, and DpJ^t^ rirk^ts. Becau^r the initial of i [it a 

operati (顺 art* C , R_ U ， and th^y art 1 kiumii as the CRUD 
operations. These are pretiy common operations in daiitbase-renirit: 
LLpplicatiDii^ — so common that Rails has a uay quickly ^ourmtiiig 
aU ihe code- and pages you need, k docs aJI this using scaffolding. 
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gening 




Code Magnets 

There's a simple command that you can issue from the console to 
generate the scaffolding code. See if you can arrange the magnets 
to complete the comrnand. 


ruby s e rip t/ genera te 


ticket name 




+ I; # + 








you are here > 
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scBffotd creates codis 



Code Magnets Solution 

There s a simple command that you can issue from the console to 
generate the scaffolding code. See if you can arrange the magnets 
to complete the command, 

siaKold is 社 e ^sed to 

CRWP 


r\iby script/generate 



i s ai1 y 卜代 

staining j decimal fmni 


So what does the scaffold command do? 


Remember th?5 ^omrhanj heeds -b 


Scaffolding creates code that allows a user to create^ 

read| update^ and delete data in the database. 

II you have a databasc-ccntric web application that needs to create, road ， 
updatt", and delete data froin a datal>aue ? then ^cafib]ding can Have- you 
lots nr lime and dTort, 

Type tlie sciitlbld comniand for thr ticket cable imo ilu ： coi^c»le, and let's 
^ee what happens; 



命 

Do 

伞 


Frla Edit Window Hiip CRUD 


> rtiby s a rip t / gene rate scaffold ticket name: string 
seat_id_ssq : string addr 皂 ss:text price_j?aid : decimal 
emaiT address : string 
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getting 





Tqst Driwo 


Now iTs limit* tf> sre si" cnir application rraily working- To 
ihe new Lic'kt'ls pcjim yaur browser Iq 

http: //localhast: 3000/tickets 


， ^hc name 9 i V(?h k ^ 

£« h<m Rails ^dt it fUal? 


:in 


w- 


C X J 


^ httD；// l&cal host : 3 00O/ckh«f s / 


Active Record:: Statement in valid in Tic 


: a! 



仲 一 ^ r * L 


So wliat went wrong? liwn i hougli 
we. gcneras^rl i he sriillokl code 
ron^ecLlv, ihere's mi t'rmr on Lht fc uelj 
sltvh All wr get m e a buridi uf 
rnw messages being sent back. 




綠 S 5 iS 


(x fe K^li l KKf lB *|!|f lfl i 


Hrt 


illi* I 


Ab I 


.j^it a 


KKi+KrT 


U.iiHM 




RATT.R^jtOOT t /IJn^rfl/ftnvl rtgVn^fiJct nri/phapl *-«cnf f n^d/t ^ nltfti-.M 

ApphcaitiQ 1 ^ I rate f hrannowOrk Tra€ft | Hilt Trace 


/Lit tTAlfy ^Aub^/Cania/l * 9 / ^c = D/A&tiv4FreQ0rd 3 »1 + 2 / lib/aoilve E-ocol'd /d^nnvQ t i.on aeL 
/LlbiE«.ry/Rmby/€«iP ： A/l ，益 Vf|em_/40tiv4£e«»d 2.1« 1/lib/jroaord/e«nA««t ad. 
^ Z-i^r . #/^e«.e / jL^ilv^rflenzd 1. - ^ ^ Apit. ^ VS r « c as A,/ ?>a ha t.1 o f% 4 4 

/Libra ry 1 / 攻 uby/SomB/t « fiV lomB /j o tivureoard 3 » ll * :3 71 i)o7 jot i vo raiaord /^Emnoe t i«n Ad 

/LibfAry/flkib^/CM ■/ L * fl /§ema/net 3 d 3 . 1 > lib/Aetivo rocord /afrnnoai£>oni_a<fi 

/L^bf 毳 JTY,llubY/Ce 纖 o/l * 愚 1 - J r«cor^/o4nnec t i«n Ad> 

/IfibrAry^uby. 4/ fBmq/a^iLjLv^repqFidl ^ . 1 - 3 ^ foiiipf 11/941111491 ion ad. 

/Library/Ruby/C *ekh /I. £■ Z^iimB/Acilvar^eard-l. 3 ^ 2 / li.faJ ii^i f«cord/e 6 nr«_eLiQn_fedi 


1 


■. a Jfe 


d / & $bfLia<rt i4b _d. 


/ILnbfAfy/SEab^/E ^ A/gdiit/ 毚 ■etivifef 嚇 Cdfd 
/Librii-ry/Rub^/C*!**/I ， i/ 34 s*/ 暴 eti>v«x«e>o>rd-3 r 1 晷 r#cor4/b4<*, rbs & 94 ti\ 

i* LibE^ry/^l'jby 人 / I _ & / g ■ 盥 ■ / 麗 , 1. „ 3 > l±b/A?t.i.v0 rAicord / 匕矗 __ . rb ： II S i 

J L.ibr ■ ry /S.utby 1 ^«aA/ 1 U / 江 a?c m / a^tl v* imranA _ 3 _ 1 - 2 V ii,b f ictxva r«cord /b&■ * . xb 1 & % C t L\ 

1iek4 tv _eotitfo<l 1-ar . vbi 5 t in ' 

>Li.bcAry/Suby/C#m« /L. fi/ ^ia«te /*ct ,1 ,1 f lib f oon tr@11#r /b««« - rb* 11 £■ 


hm ry / J lLih^/C2#mH f | . H / g ：*^h /4nf t nfijiaplr- f 


7/1 i h/art i an nfint ml IA>r/hii rhi 11 fi' 



hrn 


hy 



mfmrt inTtcdb*/, I 


i h/aitt 1 rtrt mn* rrt 11 押 r/ ft If 择 r* * m 



隹臀 


Think about the error message you can see in the web browser. 
Why do you think the application crashed? 


you are here > 
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create tables migration 


There are no tables in the database yet! 


Yhv MpjiEivjiiioii she iiiIH have f!is|>]-iyt L fl ;ui r mpiy lisi ejI sold [irks*Is* [mi 
it (Iklii、. Why nol? Ft pulled Sn mhht 1 lisl frfmi liiblt* catletl dckel^ 


in dir tiliitiibiisf, I Hit uc cii'L an\ lithk s s \'cl 


Should We — coimerl lo the dal:sb-^r , atnl rreate ihe Nihle? After 
all —— iUv lI 【血 hiisr is du.iv iis [hr 叩】 jlidiuii. IklL [Uvn, \v 1 iy 

s-hould ；\'0 have to? We already told Rails enough inibrmation For Ra ils 
tu riviftr the u I ble Ibr us. Look a^nn at "ur scaffold a 


「W Eoft"""Wlndow Wp WY 



u \ , , rw ^ TJCkci 

_ 以％ w, 


> ruby script/g^nerate scaffold ticket nanie 
seat_id_seq:string address:text price_paid: 
email address : string 


l string 
decimal 




tickets I 

name 


string 

seat id 

seq 

string 

address 

text 

price paid 

decimal 

email address 

string 


Wl. dilnead\ , lold Rails llu j tlrUiils n|' Lhe data tsii-LKiurc when uv 
# 

ran tlie scaflbld conimaiid, iirid there is an imporiaii! piint iple 
in kiiLk Don y t Repeat Yottrself. 11 y[ m td] Rails ^f ； >Jiuilnn,g 
oiice, you shrmldn t have to 19ay it 


So how do we get Rails to create the table? 


Rails principle 



ii dee }. Bits — 

Rafis comes bundled with a database, 
SQLiteB, So where is it? 

The database is located within the db 
folder, m the file development.sqlite3. 


^Dpn ， t 
Klepeat 
^bursell 


\ 

★HHe 故如 r int ^ lc £allc ' 

pKV" ^ 


5 > 
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getting 


Create the table by running a migration 

\\ hen Ruils genn ， 疵 d i)w srallblding* li also Lf^rieraU'd ;l small Ruby 
srripi a migration lo creiiLe [lie LtlU bi :i sn ipL 

diat aJtt：rs \i\v stMU ： turi ； oi' Lhc underlying datitbtise. 

Take n lfHik in (hr db/mi^T^iLe folder. You shuukl see o !1 [e itiet.e f filled 
ctlmG3tamp>—creats_tickets . rb nliert' <tlmestairap> 
the UVC timestamp of wlieii the (ilc was created. If you opc u the file 
in a text editor, t( should k_i)k something like this: 


CiaSS Cr0ateTicket ^ < ActiveRecord^Migration 

def self , e up 

c; ：； 'at0_r.able : tickets do jt| 
t * string : name 
t - 11 ing : seat_id^seq 
fc -: address 

t *decimal : price^paid 

t« string : smail_address 

t *timestamps 

end a 1 L , p 

i {Mt towtehts + 

en d the ^ilc. 

def self ^ down 

drop 〜 table : ticket 3 


0 ncf 


end 


1 he migration k a small Rul>y script. I iistead ol running this script 
direciJy, you sh^mld nm ih k srrlpi ushiff another Raih tnol mik'd rake. 
To run the nugraiion^ [ype rak^ db:migrate aL ihe ronm^irul 
proinpL I his runs Ltie iTii^ialitm i:ode and tln j Uil)le: 


H 


db 


□ 


migrate 





<U p>_c：re 白 te—ti c ketS』rb 


K 



The 加 fl!c ^ ., 

⑽ ur , 融 

扑 d We _t 娜 ^^ated 

Dori^ wor^ryi wff II 'bdlk 

sboui, 七 his 


Watch it! 


Rails uses 
CameiCase 
for classes 
but under, 
scores for 



filenames. 

ThaVs why the migration is 
called VreateTickets" and it 
lives in a file called 
create tickets 


Edit Window Htelp DRY 




Why does the migration include 
the date and time in its name? 
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welcome to system 



Make sure vouVe creased vour tickets table with (he l ake comimncU 

^ i 




I h^n go back to [he w^h browser and refresh rIVts page; 


http i// localhost: 3000 /tickets 

l lit- web applicatii m u'orksi Within a couple of you slioultl !x 

abk i lo emer a feu- tm i ccoixis ： 


Mtp7 / BDCliPMHlJlKMiFfiClill i 


Listing tickets 


Yes - we’ve built much more than just a 
front page^ WeVe built an entire system- 

SL itlTfjlduig ii whok- si；l nl pag^-y that ixlluw 

us Lo create, mod if V, and dflclc licket details, lb see 
hou r die applicaiion liang^ together, let's ctxatf- and edit 
a not he i 1 record. 




Lt —塞 hc 

irfc HwMlinc ?H 

W NcMy MsndflrtuMTi SSJ 


勺 Prdp*lincB(owffV M >4 I.Q 

P26 Hui Av« 4 Cftrfibflo&t, HA J7.0 
® 4 . HU 


WyilliJEwiV【:lT Wf SFID^ !id|| Dmlnff 
fHt# mMHiftrumaK. or g 
n»lly 礬 -tem 


Wait! No Way 1 WeVe only 
entered a few commands 
at the console and that 
built 肀 he entire app? 


s 


Alan Ixu^mufer 


0 *ri| 43 h& 


17 Tg^af Ma ^5^0 


1^1 *rk ffr$il#imi (I. c*m Sfioft [d!; 


Itf K 1 | 

IA 


prk* p« 4 d 


cmiM 


fid -0 


al .Cism b^tgw £^kt 


AdOrvst 

11" fdt 作 L LlU A^fiPii' i3 


arc a 
■fifw redohls 
w added. 
ahead and add 

1WFI ^ ^i^ScJnf/ 
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getting 


N#w 


㈨， suWit ihe W, ^ rt 
able tp «ad ^ tickei batk 
irom the database and dis?by，t 


• W * ，一 ■> wS^mi !■ |4 


*)■!!■ P *% ^ 

»■_■! MV M 


\ 一 


Listing tj 



ClikM ^ 如 

ikt “七 p 哼敁 e 〒 b 十 

▲« p 如 trcaif ^ tltk£t 


M c Ed ' button oh ihe display pa_ 
JJU 5 y w ^ update any ^ta ， f s yl Lc 


iditing Hclcrt 



^i^L 0 re WC ^ 5 ^ 

delete a titk 芒 t 


you BfB nere > 
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BU1IET POINTS - 

_ The command 

rails <app name> 

generates a web application for you in folder <app 
name>. Rails also creates the folders and files that 
form the basic structure of your application 

■ Rails carries with a bundJed web server. To start the 
server running, use the command 

ruby script/server 

The default home page is at 

http: / /localhos t:3 00 0/ 

■ Rails apps follow Convention Over Configuration. 

_ Create, Read, Update, and Delete operations on a 
database are known as the ORUD operations. 


Scaffolding generates CRUD code for you To create 
scaffolding for "thing data, run: 

ruby script/generate scaffold 
thing 

<column name l>:<coIunm type 1> 
<eol\inm name 2>:<column type 2> 

To see your scaffolding, point your browser to URL 

http : //localhost: 3000/things 

Rails epps follow the principle Don't Repeat Yourself. 

A migration js a script that alters the structure of the 
underlying database You run a migration usmg the 
command 

rake db:migrate 


iKereiOre no 

Dumb Collections 


Oj Some commands start with i i 1 s and some start 
with ruby and some with rake. What s the difference? 

八 ： The ra i is command is used to create a new application. 
Bit ruby is the Ruby interpreter and it is used to run the tool 
scripts that are stored in the scripts folder. The ruby and 
rake commands are used for pretty much everything in Rails. 

Qj So what’s rake? 

rak© b the command we used to run the database 
migration. The name means "Ruby make, and 1 Ms used for some 
of the same kinds of tasks that make and an t are used for in 

olher languages ike C and Java, respectively When rake is 
given a task to do (like running migr 自 tions}, it is atafe to smartly 
analyze the application and decide which scripts to nil. So its a 

little smarter than ruby and is used for more complicated tasks 
like modifying the database structure and running tests. 


o 

I don't inderstand the ' Convention over Configuration” 
thing. What’s it mean? 

Many languages give you a lot of options to choose from, 
like picking options for a new car. If you have a language that 
has a !d of opt ons available, you need to store the developer's 
choices some 训 he re - usually in [arge XML files. Rails lakes a 
different approach. In Rate things are named consistentiy and 
are stored m standardized place. This is called a "conventional" 
approach - not because it is old-fashion&d, but because it follows 
ucorwentions 11 o! ■■ standard s' 

(U 

So l can t change how Rails works? 

You can change pretty much everything in Rails, but if you 
follow the conventions you will find that you will develop your 
applications more quickly, and other people will find your code 
easier to understand 
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Sweet! You saved your buddy s job! 

Y(vur quick liaih work saved ihe day for your p:il ai IdsL ， for 

ilw rntiiTieiiL- 14)t>ks lik( j 1 here's anoihtT tMiiitil k_ dml uith: 


Thank you! 


Its qreat to see the application up and running - 
Sou did it so quickly! Rails sounds amaz^ 
The way changes appear as soon as you e 
code. No compile- No deploy. Must be nice. 

You really saved my butt on this one. 

Just one thing-the labels for s H= h a = 

be something more human-readable I ke maybe 

“Seat #' Do you think you could fix mat 


So how can we change the labels? 

Rails generated a web app for us very quickly which saved m a lot 
of time and eflfort* But wliat if we want to make small changes to 
i\w ^ippeaT ： iitc( J t>f generated pages ， v\Iml p \\v do? 


How easy is it to modify the pages that Rails has 
generated far us? 











know your 


To modify an app, you need to 
dig into the app's architecture 


Smllnlchutr just treneriiSos mdi- Uir vn, i )nre tht. md/s 

bmi wnei'iU 卜 it s Ltp ti i you [u i iisiomi/^ \lm\ cmk- Anti 
if you look In the app (older, you’ll see there’s quite a lot of 
grtimikd ax\e you might wain ia s Li^tomizc. 

So il \ i >y nerd Lo mak^ a dir ujiplicahon liku 

m«xliJyiiig I l ie lal jcLs 一 ^Uiore da wu lx gin ? 


T l c a?P W 如 


lOlfV 



app 



Hmm, Rails generated a 
complete folder structure for 
us. and also follow conventions 
I wonder if we can use this in 
some way to modify the app? 


Rely on Rail B s cotiveniions. 

RnimilMT hnw we chni limits : ippN 
U illow romvtuion^ nvn' t < 

This will iii^iki' il riisirr Ini- us 10 un ulify ihv 
>n B Wtiy? VV<;1L Imaisc ihv k 
amicHiig i" it\ function，I IilII 
ill earn Ruby scrspLs iha* do f/tit^gs Ii\ F e 

in simihii p!(Jcr^ 

So if yow nerd to diniigv ihe hehavtur t>l 
your R^mIk 叩 plimiim you should Is^ ^ihlr 1(> 

p l『.i 丨丨 il '■ ■ 人 hr I 丨 ■ I hr I I H\r ihiil nm h i! i S"' 

g 

L-tiimKlcil. anti rlian^c* []w rocle. 

But of course tr> do that, you need to 

tlw. 



SfandarJ Kails Architecture 




controllers 


application.rb 


tickets c antra Iter.nb 


helpers 


app I jcatjon_helper rb 


tickets_helperrb 



models 


i 


ticket, rb 


P 


views 



layouts 

tickets .html.erb 


II 




tickets 








戀 

圍 

讎 

圜 


edit.htmlerb 


md^x.html.erb 


new.htmljerb 


show.htmLerb 
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gewng cjrred 


The 3 parts of your app; 
model, view, and controller 


F J re1 ty rnurh fill ol' llir rode in a Raih af^plii ation lalb inio ime of 
thrt^ CcLiegorieH .： 


o 


AAodet Code 


The iiKidel cs.jde how Ullill wriueii and read 10 yi >ur didaba 此 

ModeJ code objects represent things thiil exist in the system's pmbkm ^ % 

This 七 he busies 

problem ywr aff P s trying by solve 


dommv like tiic tickets in the ticket svslem 




View Code 

The view h the pail of' the applk ation that k presented ； to the nsei . 
For that reason ins sometimes called the presentation layer. For a 
ueb application^ the view mostly generates w^b pages, 




Controller Code 

The comtoiler is the real bmin of the application. It decides how the u&er 
interacts with the system^ controlling what data is accessed from the 
inorld, :md which pans o\' I he view will present ii . 



This is how the different types of code are connected in a Rails application: 



View 

Tk toisift of iKc 
wct He 


Liier 



/^Controll er 


The to^broWtr is tKc key dtch 

ft wKdrt data 
needs ^ be the 

3hd wliidh pat 七 of 
^i*w will display 七 Kai data- 


ion 


P 



Modd 


The model cr«ulst« tHc 七 
m ^thc r-fiil wwld "tKftt 

tidkei sy^b^i kkf 七 

objet-U wodcl 


you are fi 
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RaUs Exposed 1 

This week’s Interview: 

We ask the web's hottest 
framework what makes him tick 


Head First： HHlr_ IUI、we rm ^rhid YOU rmilcl 

|niiii us. 

Rails: 1’lmsf - n，ll me Rcty ( jIhcI to 1>e liere* 

Head First: h mihsi lx- Uju 0 i Ko Iji id a ht-ak in y< mi 
hef sic schedule. 

Rails! rm busv; siuw With database ci.nmocdom* 

X 

Hippiiciitit>n lugic. and wi \> \u sei w up ] ih m l 

a bt of what ycmVi call “Xh lime 1 ". But ii ? OK - 

I htfivt 1 piMid 

Head First ： ()ne rhiiig 【 \\vis Wjndering: if \m\ 

dan I mind me asking when you rreatn new 
.-ipjviraLiuiL why ujv llu.mi i.lii> i rlnrk , s. h 

Ralls: Wlim mil I say? I v m a helpful gviy. Owi. time 
I\v Ir-ifiied whiil kinrki pt^>pU j \v, ： ui( in dc > in 

Ltirir ap])[k^Lions, f drm'l like i() srt_ !.n'(>|)h. nicUUULlly 
t lULijig LI \v ^ame sttifl n\ct rtiid owr agaiii, 

Head First: Hiil isiTi \i ：dl u liult* … wHL. 


RaNs: Please. I ni a guy. No ^arpri^s. 

Oim VtMjVe learned lht j w liv 1 work, vt^i ll llml mr 
easy 1 (p Lilrmjr ， villi 

Head First: f li^ ;sr vrsu do n ( like 3 to he roullgin ^d, 

Ralls ： V>ii i nn amii^un. itir il. yon lik<\ lint nmsi 
people prefer im w jrk (he way I like, t : 。 "'viUi”” mvr 
< oiC -apiiile? 

Head First: Oh )n that's nii r of you I' dcniirn 

pi inriplrs is" 、 it? 

Rails: \tah - Hint and l )<m i Ro|xal Ybm wlf: 

Head First: And what? 

Rails: 1>Rqxai Wmrsi lf; 

Head First: Ami w\vai? 

Ralls; H: k Vi >EJii it ： ij [iimiy 


there ^ 

Dutnb 


eicire n9 

Questions 


Where should the business 
logk go in my web app? 


j\l Well, it all depends what you 
mean by "business logic." Some people 
define the business logic as the rules 


controller. In the rest of the book we will 
use "model logic" and M dpp9ic：ation logic' 
to disting utsh these two cases 

(V 

What is the difference between 
the view and the controiler? 


associated with the management of 
data」n that case, the business logic 
lives in the model. Other peopfe define 
business logic as the rules defining the 
workflow of the system ： - such as what 
features the application has and in what 
sequence the user accesses them. In 
lhal case the business logief lives m the 


The mw decides how the 
application looks and the controller 
decides how rl works. So the view will 
define the color of a button on a page 
and what text appears cm it but the 
controller will decide what happens 
when ttie button Ss pressed 


So what code will I write most? 

/^ a It depends upon the appircation 
and the developer. If you find that you 
are mostly adding code to a particular 
one of the three app parts, you may 
want to think carefulfy whether the next 
piece of code you are adding is about 
presentation, interaction, or modeling. 
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getting 


> Cm ♦ 

• + 

Matcli ihc code description to die part oi the app that cckIc goes with. 


Tlic j c lesion of the tiards in your rmlint j 
: Mon i\ iranie, 

£ n 



In an online banking application, 

thi^ code decides whether you 

€ 

vvanierl to transfer mnnrv in or 

t 

out of an acrounu 

An ^appointment'' ubjcLl in ^ 
diary applicationi. 

In a blo^ system, this decides 
wlieiher u ■ diKplay^ comment ^ a 
table or a list- 



Jills ctide records a bid on an 
auction si 紙 


Decider you need to log in ta an 
emm\ applic ation. 



Model 



View 


A menu of Imks, 



you Br^ here ► 
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model, view, 




c% 


* 


• + 




Your job was to match the code description to the part oi the app that 
code belongs in, Whm did you romr up wiih? 


The desif^n of the rards in your nnlint 3 
SoinJ Mont% Lvalue. 

1 O 

In an oiiHiil' banking application, 
this code decider whether you 

i 

vvamer] (o fransfrr mnn^v in or 

r 

out of an acrounL 

An “appointing ii「objctL in 
diary application. 

[n a blo^ ^ystrin, this decides 
wheiher ht cUsplap comments aTa 
table or a IhL 


J his ctide r(xc_rcls a bid on ail 
auction site. 


Decides ymi need to log in m a 
emm) applic ation* 


A mcnii tjf links. 




Model 



View 



Controller 
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getting 


The 3 types of code are kept 
w SEPARATE folders 

Si h Rjil 、 la\^.n>i i <mvnitum n\vr ' ill and 

us<.^ the M\ C 1 aichiLrclitri. 1 , Sn uiiai/ 

I h >\v clous sJio M\X! an hiiecture liolp us change the 
Lih<.'h on nurpagi、miul lix ilw app? Ks h >t?k back 
M tlie iilcs that were generated by die sealtideling our 
more time. Because the code k cleanly separated into 
llin'i" i1ih iiui t\]ies — modpL view ， and cnntroUer'— 
piiLH eadi lypt! in a sqmiik. Ibltk fc r. 


- ^^irpen your pencil 


On the folder diagram to the right, highlight 
the files that you think will need to be edited 
to change the Eabds ir> the pages. 

Then note down why you chose those files. 



app 


Here 8^r€ the 
eorrtroilers , 




^JodcJs go K^vnc- 



con trailers 


applic^ition.rb 


tickets controller.rb 


helpers 


app!)cation_he!p 0 r.rb 


tickets_helperrb 



models 


I 


ticKet.rb 


<s Jr Vcm*'" 
MS ^ 


p 

| views 



layouts 


| 

tickets 


峙 | 

司 edit.htmLerb 



index,htmLerb 

LJ 


峙 1 

new.html.erb 


“1 

^ show,btmKerb 




















fabets are 


parpen your pencil. 
W Solution 


Your job to highlight the files that you_H need to edit to 
change the labels in the pages. 


we ^ced to 七 he o( ihc 

p30p$, ^ need to dh^ngc 七 he tfigws. TKc f fcle$ 

、yc need bo uyd^tc 3^c found ih the views folder 
and have 七 he extensiw ■hU-^rb. 



JVe ta h iha^e labdi ^ tKe F aa c 

叫”心 - H >| 价 fa 办 
the views +older. 




app 



controllers 


Pv 



helpers — 社 e f iles the tontwlkrsj 



mode 治 





views 


ZJ _ ts 


kets 

dtthtiriLerb 


index.htmLerb 



htmLerta 


.htmLerb 


The files w the VIEW need to be edited 

II ue want to change the labels in web pages, we n^d to modify view 
roclc 3 , Anr! lIk yi^w code ;lII lives iusiHr i hv app/vi ews; Inlrl^r 

I he \ files ^ nrrate wch page 、 anti air cal [ed page temp fates. 
So what's a pagiff tpmplatf% ;incl ul】』u rlo those rpmplait^s contain? 
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getting 


Edit the HTML in the view 


So wliiit do \lw p^ifre Lfrnplaim actually look like? (>pen Ihf" 

(bur ■ h Lni 1 - erb files in the vi^ws / t ickets fbldt a r using it text 



!■ 


%> 


<p> 


@ticket 


n a 膽今） 


^r# ccd 






</p> 


ck& t</h 


<9> 


m 


<b>Address：<- /D ^ . 

@ticket ， addles5 %> 




err 。 




Ks 


^ ■ -^^bel 
f € t ex t 




If you edii i]\v labels in \-our 

11L ML. vour diaiiLreH bi'Ctmir 

■i / »r? 

immediatdv visible in vonr web 

ir m 

browser If’ you make the cbbilges 
nou and they slim a Id be 

visible mmrdifiit T h\ inkm look 


如邮 %>< br 7> 
field h 師 e % 〉 


Go into each of the four 
■ html . erb files in the 

views / tickets folder, 
end change the text 
Seat id seq to 

Seat #, This will change 
the label on the pages to 
Seat#, 




ii 


Sc^i # J 


[■ i a ： b^ 


se g %> 


tiereiore no 

Dumb Qm^tion^ 




nexl … 


txlilrjr The ctjnteiilml thr files Isxjk mi avvfUl Jol like [ I lML. 


We Wiint lo dicing the labels for lo Setil #, Th do this, 

search, for Llie it k Xl hh Scai id strq'' in die four rdc_% L'hfUig^ it to 
"Seat #’’，and then save your changes. 


Qj You called : seat, id seq 
a symboL Whafs a symbol? 


A symbol is a little like a string. A string 
is surrounded with quotes, but a symbol 
always starts with a colon (:). Symbols are 
generally used to name things 


in Rails because they are slightly more 
efficierl in memory,, In most case^ symbols 
and strings can be used interchangeably. 















change now, sqp : lv 




Tost Drivq 


the page at; 

http ： //localhost ： 3000/tickets/ 


Ivrl'V fw* 


m 


c 


+ H rvitp // t 1000/1 C 


ht the kbch 

吻 d H 氣 


_ * c 

< J + M inp/i infAiiwu 1 locamd 

Editing 



* * c 々 + 0 Nttp f 難 



New ticket 




Aidn L jS^gmuFi 

S#At * 

1a 

Addrni 


Nam*« Aiart Lar^myir 

5«al <i lA 
Addf«Si： J7 


Sililt * 


彎 


C <-J + #4hrrp " Infill:h^>ii IDOO/UfK^tv 


^ r^t^vs. puce vain. *o.o Listing tickets 

Ern« : il aditmsi I 


MA 




Niint 

Mat M 

Aisn L&nQ^nuif 


^□rdan Cl^iFk 

€3C 

&oiifai i ㈣ r 

54C 


Flfel 


Addr«ii 

17 Newbsirv rm 政 Ajhfkeidp ma 

1? Tudcir Cqmltrldgi' MA 31.0 

9 M*^n Su«rst r ProvmLflMun. 铒 】 43 .,0 


1 )if] \.m] iioLifH 3 how qijirkly the Hiange appeared 
in your appliutitioii/ 

I h^l s l^rausf Rails is hniit w\ih Riihy^ and Ruby 
t c.jde difcsn i need (<» l>e* i'nmpilecL %u iJu a Kmh 
web server cun just run your updated syutce 
code. Bui h that really a big deal? 

So yr>iA e gm a loL fewer yiageis you net'd lo go 
tlirough to try oui code that you change. You 
doift need to compile your code™ tor hi^tancc, and 
ymi cWt to package that code and depk^y 
il anywhere. All vou nerd to do is write v^uv code 

14 m 

and run iL ] lw Railn devt 5 lc>]>mt a nl lyvlv is prt fc lLy 
quirk. Lind it’s c|uick U> nuikr t han^rs Its your wvh 
app, too. 


咖 w， dtodc 





It 

kr* 


evaht 


When youVe 
tl 咖 3 i ㈣ R 威 
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getting 


Sunday. % AM 

I\\!3 fix ，、 cim' n, hui yi mv phi pni-^ rhiLfing … wiiai nsm? 



Hey there! &reat to hear about haw well the 
application's going. Hey, Irsteri^ I thought you ough 肀 
to know that my bc$s 勿 lle<J and w/cmtsd to know wh^re 
you five. He was redly ^ager to ^ee aff of the work that 
you'd done, but he's stfll a little worried that it might 
not be ready for tomorrow morning, so he wants to 
check today. Thanks for all the work you. did. Oh - by 
the way - did I mention that he wan+s o contact phone 
number recording as an email address for each 

ticket? Sorry - slipped my mind. 





knocki 



、 i I / 

一 KNOCK! 







So, youre the one responsible 
for the new application. The first 
concert bookings are syposed to be 
available in hs$ them 24 hour£ r so 
this app hod better be complete or 
I'm going to want to know why... 


getting 

The application needs to store 
more information how 

livrrytldng wiis putty niudi tiiai^hi^l nrMil ymir Mt ml nu-ntirmed 
ilrM p'luntie iHimlxrs m t d in lx- iccoitIccL UV turecE mnn ： flahuu 
wlial's iliat mt"an for our app? 




We need to stare an extra column on the database, 

\W liped lo sHnv “11 extra column in our dnmh;is【' hni linw? 




tickets 

name 

string 

id seq 

string 

address 

text 




Sharpen your pencil 


We ne^d to add a coiumn to the databaiG table. Write down whai 
type of script we used before to change the database structure. 
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migrations 


You w&re supposed to write down what type of script we used 
before to change the database structure. 



A migration is ju$t a Kuby script 

So we need a migration to add a column \o the tabic. But vvhaf is a 
migration, really? Let's look back at the one that created our ti( kets iahle, 




\\^ need to t.rmie vod^. llial's stmietiiinp [ikr lhis + except iEist^ad of 
creiitin^ a tiible f Wf nufd uur irngrtiLson Lu add a t'olLtnin. 



<^l>8rp0n your p6noil 
'k Solution 
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getting 


t^erei£ire no 

Dumb Questions 


Q: 

Some of the cod^ iri the migration 
looks like it is dropping the table. Why is 
that? 

Migrations can do a lot more than 
we are shewing here. For example, every 
migration has the ability to undo itself. 

That's why lha code to cmate a new table 
ks tnatch$d by corf© lhat can drop the 
Bui you don't need to know much about that 
just yet. 

Qj I don't need to understand the 
code? Isn’t it important to understand 
Ruby's code to master RaiEs? 

/\: Tlie more you understand Ruby, the 
more control you will have over Rails. As we 
go througti the book, you will learn more and 
more about the Ruby langyage. 


(v 

Ifthe migratiom is just a Ruby 
script, why do I have to u&e rake? Why 
can 11 just rm the script? 

Good question. Some Ruby is 
designed to be mn directly and some is 
not. Migrations are not designed to be run 
directly, They are meant to be run by rake. 

c >： 

Okay, great - but why? 

j\: rake is "smarter'’ than ruby. When you 
calE db:migrate you are actually saying 
lo rake, ‘Make sure all of the migrations 
have been run H . rake may decide not to calf 
the migration if il doesri F t need to Ruby earn 
make those kinds of decisions by itself. 


(> 

Csn t! just edit my tick«l$ table 
manually? 

You could, but it is better to manage 
your database structure with migrations. 
When you make your application live, you 
will need to recreate your data structures 
in your production database. If you use 
migmtrons, then rak$ -will be able to make 
the dala structures in your procfuction 
database match what you need for your 
application, ff you modify your data structure 
manualiy, things can get out, of sync pretty 
easily. Like most things in Rails, if you go 
along mih the conventEonal way of using 
Rails, youll make things easier far yourself. 


Rails _ generate migrations 

R^nu：nibtT wlu i n wc j^nt v r "“ 乂 J ihc st'iiUdiiig 

ruby script/generate scaf tol-i t- icket tiame : sti i no seat_id_se'j : stt Ing 
address t text price paid i decimal email address : string 


Qeneits li srripi lu nxmr. Ru!n r n )di\ And \\w neus is lhat 

i tli ^es\\\ jus/ VM'iir ulUdiiy rail r A\so gt 會 mU. 


Now siiji-i>tisr vni[ urrt a … wpv in this cummaiid 


l: 


ruby script/generate m igration PhoneNnmber 




iwt afb 兩切 ? e 


iri 


I his mukl yviiemU 1 a braiul nvw I 山 mk mi^radon l\h\ W_: rmd[l rim add 
in ihi- Ruby oxh^ 10 the « ibbr. T]k tnn 山 lc k vu a know hnw to 

\\t\W the cndi' to rnniplete lli^ mif^ration. 


So what can we do? And what can Rails do for us? 


yOU BFB tlBfB ► 
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naming 



Wve your migration a 'smarf name, 
and 史 ails writes your code for you 


l&ni’vt- pL cjbably notked by now tfiat namen arc mdly iinpi>itan( to Rail 、 
VVlicn TiVi created scaffolding called “ticket” Raik made the app visibli：* 
at hitp://k>cialhr^t:3f)f}0/iirfcc i ts and generated a migration, tf) rveate a 
r;illeTl ! irkris, 


Namingconveiitioiii> mx- im|xirtam in Kaiis because they s 4 ive you work 
Vhv Srim< j is i mt 1 with h ⑽ wu n ； irnr nii^r-iEiotis, Inskwl t >1' jnsE srivin^ 
lliv nt'U 1 miyi'uimi : niy old luiiue. Ivy ing it i\ iitimr Iiki b 山 is: 


ow Help NefeTTiesMatter 




㈣ ⑻心 


script/generate migration AddPhoneToTiekets phone : string 


S< I win. club's l \w iKimr m-ike imv rlilliTruff'? 

/ f 

knows tliai a ill igniiinn railed Arid … To … is prolan lily ^o\n^ in 
ridding a pnrtirukir mli(inn to a p<n tirul;ir so inrad of jiiM 
t^ k iUTLUi]] n Li hkviik miwiilion Inr Vi m U y liil in, Rails tviii actually 
write y^tir migratioii code for you r 


识 s 


AddPhoneToTickets 



^ddP^^cToTitkcb 
tabic. Tins is jus-b ^otho- 


tickets 

name 

string 

seat id seq 

string 

address 

text 


price/paid 

—\ f - 

e\ai W ardc 



^hone 


strinq 
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getting 


You need to rm your migration with rake 


ihn* mij^Firiiion !h«ii Rails rl^wrly ^^ntTal^s for you. 



rake dbemigrate 

But am hc do that this lime.』Alter alL we don t want rake to run the fim 
migration again by mistake. 


TtmestaiMps tell rake which migrafiom to run, 
and in which order 


Raib records the latesL Umeslcimp of all 【lie iiiigraLirms it rims* That allows 
itike to tell u liirh mijrr^dons have hvvn run anil whifli havm’L This me^ns 
tliai vv]ione\-ei j yuu tun rake db imi grate. Rails will only tun the 
latest migrations. 

Let's put ilik to rhc tcsL Run lake db:migrate a^aiii to Lidd tJie phone 
column to th«： j tickets tahk\ 



d 办 tiller 

命 



> rake db:migrate 


you are here ► 
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update your 


Pot chaHgmg the database isn't enough 

Sea 11 r>|c!ing s t od p Eiud greai lircause ii you up tind e imnin^ 
\vv\ cjuickly. Rul Lht a d^vviLsiJt - 1 is LhaL cjncre i\w code Ii^lh bt j en yntfrun alL j cl h 1.1 \e 

deveioper^ rcsponsibilily lo keep tJ'R' tude up«lo-d^I^. 

We just added a plume altribtiLr Ln the dalabaise. Rut herniisf ibe forms had 
Ltlrcady heen itch Li: cl by scafl(ildi]ig. iiw) um 彳 auk.miat,kLilJy pirk*np [lie 
new plionc field. So well have to go back to the page templates Lind add in 
reterences to iha ]>liono numl>cr: 



i> 


TVliS ^ 


枷 t 。 如吨如 d b 


枷 l 伽 Urb 仏 


° Pric ^ P^id：</ b > 

K @ticket.pr ice 

</p> ^ 


<p> 

^dre ss ;</b> 

"二 ㈣ 咖 k et ， u _ a 她 物 


<P> 


<P> 


<% , £. label : e^il,addre 3S %><br : /> 
<% = field ^email^dress 


</p> 


<p> 


<%5= f , label : phone %> <br /: 

<% = f.t 抑 field ： phon^ 




</P> 


f, ^ubpiit Update 
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getting started 


<p> 


f,label : email_address %><br 
< 它 = f*text_fi e id ； email_addres 3 


</p> 


f . label : phone %Xbr /> 
f-text—field : phone %> 






th( 


e 


t0W " 


< 


th>Email address</th> 


</tr> 


<% for ticket in 


^tickets 


ticket.name 

<td ><” ⑽一 ^ :二广 

二二一 r :: 二 

<t d><%= l.i 讣 - to 5l 。 r 一 


fjierei^ire n9 

Dumb Qi] 


lestiQns 


Qj 

Why does it say ... %> in 
some places? What does the "h 11 mean? 

h is a helper method. Helpefs are 
used for things like formatting output. The 
h helper escapes special characters in 
the field like and '"S", This will prevent 
anyone from ^ubmitling text to the web site 
that contains JavaScript or other potentially 
dangerous code. 


q ： Why are strings used in some 
places, and symbols in others? 

Strings are used in the page templates 
where a simple piece of text is required. 
Symbols (the words that begin H :’s) are 
commonly used in labels. 


Qj Why? 


Symbols are memory efficient and 
most methods (lik^ f lab^I) that accept 
parameters (ike to have symhofs instead of 
strings. Bui in most cases. Rails methods 
lel you optionally use strings instead of 
symbols if friey are easier to formal, 
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the boss 



E^eRclSe 


The boss is pleased with the way the application is going, and now he wants to record events 
as well as ticket sales. Th is is the events data structure: 


Event: 


artist - the performer (string) 
description - short bio (text) 
priceJow - cheapest tickets (decimal) 
price —high - sales price of ticket (decimal) 
event_date - when it happens (date) 


Wha! command would you enteral the console to create scaffoSding for the event data? 


+ !• i I « + |i |i § • 


» + . ■函 + ++ + 


What would you type to create the events table in the database? 
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getting 



The boss wants the I abets in the pages for price Jo w to be "Prices from' price_high to 
be u To B , and event_date to be "Date". You will need to edit four templates to make the 
change Write the changes for the new.htmlerb page template shown here: 


<hl>Hew event</hl> 

<% form_for(@event) do |f| %> 

<%= f,error messages %> 

f * label : arList %><br /> 
f,text field : artist %> 


f,label : description %><br /> 
f,text area idescriptIon %> 


_E + label : prioe_low %><br f> 
f - text field fprice low %> 





f * label : price_high %><br /> 
f .text field : price high %> 


f,1abel : even t_date i ><br 
f.date select : event date %> 


What are the names of the other three templates in the app/views/events dinectory that 
wilt meed changing? 




you are here > 
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another 



ExeRclSe 
t SotutlOH 


The boss is pleased with the way the applicatton is going, and now he wants to record events 
as well as ticket sales ， Here's the events data structure: 


Event; 

artist - the performer (string) 
description - short bio (text) 
priceJow - cheapest tickets (decimal) 
price.high - sales price of ticket (decimal) 
event_date - when it happens (date) 


What command would you enter at the console to create scaffolding for the event data? 

作 by gehc^aic sia^old even 七 ^itc_lc^j ： dcdima[ 


+ + 


+ '#■ ■ !■ + + P 9 + 


EM + + H b I; h 4 + + i fl + + + i i + # l> B 1- + + -% i il + + fc ■ + ■ 


What would you type to create the events table in the database? 


rake db-fcViiaratc 
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getting 


The boss wants the labels in the pages for price_low to be Trices from 1 , _ce_high 
to be "To \ and evenLdate to be u Date". You will need to edit 4 templates to make the 
change. Write the changes for the new.htmUrb page template shown here: 



What are the names of the other three templates in ihe app/views^evenls directory that 
will need changing? 
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test it 



1 he appliralion now ha^ all of tlur contact iJilbrmation or llic 
rickets [Mges ： 




€ _ 




C 


+ Hi ^ttp /i wr ^OQOit itkett/u edit 


Editing ticket 


ui m 


P»l 

iM ii 


fifllTie 




SttBf i 


N W ticket 




■■ »«■ 


17 Nr»rt?uhr ftwti 
h'A 



And idl of the mnts iiiJbrmadon h liIscj rimU: 


■ ■ ■ ■ »T- ■. 

LtvtlrlQ tvtnts 

^99H 


i 4 



w#nt 



A It • 册 丨 - 

_ 



I* ■ 


This looks great! 
Looks frke you've 
saved the day. 












getting 


The concert is a selhoof! 


Hie runs pn lVriK all ；mcl i]it j iollowiiiy- 

Frkkiy "ighl ， e\^ry seal in (iu k in sold. 



Phew Tho^e tickets sofd 
out fast;.. Ready for a 
little boogy action,, guys? 




BULLET POINTS 




■ Rails foilows a Model-View-Controller architec!ure : 
known as the MVC architecture. 

■ Rails generates separate folders for the model, view, 
and controller code 

■ Any changes you make to your application can be 
seen as soon as you save your changes and refresh 
Bhe pages in your browser. This is because Rails is 
bmit with Ruby, and doesn l need to be compiled. 

■ You can make changes to your table structure using a 


migratFon. To generate a migration that adds a column 
to a table, use the following command: 

ruby script / generate migration 
Add<column>To<table> 

<co lmm>: <da ts type> 

_ To run a migration, use the command 

rake dt:migrate 
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rails 



Tools for your l^ails Toolbox 

You’ve got Chapter 1 under your 
belt, and now you’ve added the 
ability to create Rails applications to 
your toolbox. 


Rails Tools 

raiU 

C^ea-bc an 

wtY s£^ft/ iervcr 

g{Bri tk£ a 打邮 

ru b^ sta^old-- 

CRWD todt ^ a r,odt\ 

七 st^ft/jcncr^tc 和中 

石⑽如 aalb 如 d 砂财 ^ utW 
rake dWiyrate 

R_ new mirations on iKc database 
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2 beyond iscaftolclmg 






Rails apps 9 made to order 




k 



He r s gorng to get a ^hock 
when he realizes I ve fitted 
an after-burner ； 


So what’s really going on with Rails? YouVe seen how 

scaffolding generates heaps of code and helps you write web applications 
wicked fast, but what if you want something a [iftJe different? In this chapter 
you'll see how io reaHy seize control of your Rails development and take a 
look underneath the hood of the framework. You fl learn how Rails decides 
Which code to run, how data is read from the database, and how web pages 
are generated By the end. you'll be able to publish data the way you want. 


this is a new chapter 
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unwanted 


Me 菸 ay, Ine. needs your help 

[hc. is a sales company ihiit helps people srll Ehi-iv nn^ iinied 
sltilT i )ntint\ l litn' ncfd n new vmi.013 of [lit k ir silc, ami l Iicy nrrd you U ^ 

l]clp tlu. h ]II OLlt. 

Th plan* nil iLcI i>]i slu v site，the sHItT r:iiu h'Ray on (heir toll-free 
imiiilm :intl giu's (lirir srll^r ID [mcl ihv of \U\- ik ni eIk-v v\ tint 

io Ktll. M^Bay lias ihcir own d^ta cniry system, and your Lippi ic at ion is 
ticcded to piiblish 【 lu_ iN 1cBay ads online, 

MePay will store their ads in a database 

AU of Ihr i'lds n ms.ii" I hr same types of information, and Me Bay wantn 
(u Htci]€ die iidn in «i dalii(>ase. I Im II insert ihe chu imo tables \ou 

w r 

y n_.5ir ulm y”ii I mikl the app + Tht^y need something like this: 


tV it« w 
as ^ t 故 ^ 


fee 





TVie ^ ads 
「 \ooV 




Hane ： Moo$eh«a<i 


O^crfptfort ： Sightly Hotti-eat€>i* one of tti* arttferS IS broK^ and 

there p S a Strafe b«hfHct the ey 的 … 

price： 2978-25 






^srbertfd 


Enail: kathy@hot«ai|.coH 


aren't Aoif.i 

^ 祕 y ★ SG 

■ U +Dfcr F^s oti c 

一 3 
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scaffolding 



Sharpen your pencil 


Suppose you were going to use Rails scaffolding 
for the website. Fill in the blanks in the architecture 
diagram below. 

First, you'd create a new Rails application called 
mebay using this command ； 




Database 
Mod 白 l 


The _ _ ___ 

contains the application logic 


I 


Editing 


The 


■ ■#■ ■ ■ i + # 


is made up of web 
pages that ailow a 


#i«Mr md 


user to … 


and 


data 


list Jug ads 



Would there be any problems using scaffolding for this site? 


/ou are here 
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scaffolding has 


Sharpen your pencil 
^ Solution 


Suppose you were going to use Rails ^caffotdirrg 
for the website. Fill in the btanks in the architecture 
diagram below. 

First, you'd create a new Rails application called 
mebay using this command: 








"Th,s A -foidc^ 

^■cbay ind a lot o 4 - sub^oJd ems 

ih^ dfflid^bioh. 


Database 

Model 


The C wtvol tev 

P PI 1 * i > I 1° + e ■ ri t § 4 + ■ 1 ri -r 9 4 + ■ ri -i- H 4 + F i + + fa 4 ft 

contains the application logic 


i 


The "_fe 

is made up of w^b 
pages that allow a 

user to … 

read * _. 

■… update … ■… ■ 

and dcle^be data. 

H ， 《 ! ■ 甲 * + B P ■ L » ■! ， + i 



Would there be any problems usiog scaffolding for this site? 

TKe piroblem is that sM^foldih% «!nerases todt that allots use^ ht edii 

"the 如 d McB^y only W^irts bo FL-blisH id^ They don't wAht anV^^t 

•liid> + +l!d++pi!!t>4+Si§n++l!B4++«B4++%if + +ii + f!i+#ii++i<i#4»'nbH + |i°hi+ + +5^+ + +Bl++l!S4 4 p- fi t i S i + + fa i + + + h fi #4i8> + +i+ + ^f<«igl> + +ii# + +feB ■«++!; Bid •疊 

柯 ihe and debits an itewt- f\\\ o^r thrC will be ervtc^cd W 

響 ， P ■ ■ 辱 4 ■寺 P 1 4- + -P H ■ *-U- # 4 4- + + P B % Hh -P P ■ » + •!> ■ H Si ■ V + -P B R 4- + P I 4 + -F f I 4 1- # B •« 4 + -fi f a % + P B S- 4- # 4 « a- -P -i ^ p ■ I. if. + I V «• + P fl I 4 + f ■ 4 » + P R 1- S| « "p 琴 F i 9 4 f P >P ■ _ ■ 4> P 

A1cBav ? ^ o^n svstciiis so—Foi" at least—they wlv weed to display ad 

e_ _ ■ ■ ■■ 鼸 _ 齔 _ ■ ■ _ u ..■ ■ ■ ■ •邐 f ■ a ■ i _ . ■■胃 _ ■ < ■ _ _ _ ■ 酃 .；k _ ■ _ a _ ■ ■ _i si; _ _ ■ _ oi ,_ ■ ■ Pi _ . ■■亂 JL ■ ■ _ 亂 _ i^p ■ ■ ■ n：|i ■ j Jhibbv ■»!■■■■ ^ylw ■■■■■•■■■■_ ■■ 屬 ■■__■> 
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scaffolding 


Scaffolding does WAY too much 

Mdy ^v；ml :m applicaiinn thal does fej than a scfifirilded app 
would. St ! alli>ldiii^s grtm, hill smut， ： jpplit iukms im k ho siinpk 1 thal 
\ oil'll h<ji Lie tin it's Ik' LkMUt ull’ huiklui^ u nil aj?|j iiilII] nally 

So why^ that? Well, if you ^Tiie the code yoursplf^ i]ie appjic ation 
will hr simpler imd Li ^ irlaluLiiiL 】1 ]r (Jr 卜 U.iksitlr In tins 

h iJiai in t>rclei. t<] huikl n R^iis wcb app inauuvdK; y< n« uccd by go 
under the hood and uncii rstand lum Kails really works, 

sum hy m uhat vot\v you need to ct^iiv Jbr Mt Buy: 


You need to associate 
URLs on the web 
with the code In your 
application. 


Koullng 


Model Controller 



You n@@d to crests a 
table in the database 
and mode} objects for 
the MeBay 


You rm 白 d corttroHer 
cod© to take data from 
the model and send it 
to the view, where ads 
can be displayed, 


To liuild an app 
witliout scailolding, 
you need to 
understancJ liow 


Rails really works* 



View 



Unlike a scaffolded 
application t you won't 
need a lot of for this 

app, MeBay s^iy they only 
need a singts page that will 
be used to display each ad, 


So ^4iick code will you w Fi Le first? 
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model Pf ■ 


Let's start by generating the 
MePay models 

li\ a idrii to hfgiii with cTraling tlie model rodi% 
lmi lisi. tlit a stracluri! uf [he daUt in ihv model afil 卜 t ly ]>olli the 
eon troll ■: ，r and the vivw-. 

CrtMiilinjr nvjdt?] is very similar to ci t j atiitjr .sc ： illoldin^ In 

fact，ihe only difleivncc is iliat you replace ihf woixl “scaffijkr 
with the ward "modeK" like this: 


M=kf 

D 


you are here 




F*e Edit Wmdgw Heta AtJvarlizeMe-Babv 



> ruby script/geaerate model ad name : string description : text 
price : decimal sellar id:integer email:string Img urlistring 


\ "h i l nu)del-genes nix>r command rn ：i ares iwo key 

scripts wiLhin uie app and db subfoldf-rsr 


_ the model class 

(a pp / mo de 1 ^ / ad 

_ the data migration 

(db/tnigra te/ - P 


b) and 


Create ad a - rb). 


The migratiem is a Ruby script iljat can cormec 
Ua the driLalja^e and fieate a table Jc>r (iiu auk. 
lb run ihh 祝 ript and create the tabic, we need 
to me rakG. 



This is jmsI like vC did in 

Cha?t cr ^ 珈七 

whd ^ bascd 

on 




These Adders will hive been 
treated 3u ^七以 IIy by 
bih you app 



app 


models 



ad.rb 


tKc ad^rb ^ , 
⑽ 如 “ lles 



.,create_ads.rb 

This fiJen^e ^,1(1 

j ： 









scaffolding 


... and then well actually create 
the table using rake 


n 


lb create tlic tablr, \w iu:rd to call ttic migiatiou using the 
rake db:migrate commancl: 


you are here 


Fits Ectrt Winaow help Advsrtlz&MsSaBy 


> rale 皂 db :migrate 


Re mem be 3 ； the rake db ： migrate r< min land rreates 
c\ table in Lh^ ckilabaAt' using Uif , ■ ■ create ads . rb 
script you ju^L created with mode I, 

Hlil \i yuii wei r Li> took m]lv ：w Lhe u\\Av it cn fc ； iit j s, 

yuu’tl str a Liiin^. Rails LTfalus three t 卜 xb'i i.olumiis in 

the tablt without being oskai. 


□ 


Tlve ” ke db ^mriic 



db 


I > migrate 





createads.rb 


Tht'se iire t'olyinns'"i id, created aL 3 luk\ 

updated at. TUv id column li genera Led priimiry kt ， y, 
find created—at and updated_at record when tlie data 
h entered or upriaied. 





: Rake creates a table for you tn the database, but what 
: it doesn’t do is populate that table with data for you to 
: experiment. 

: You re going to need some da la in the table before we 
: get much further Fortunately, the kind folks at MeBay Inc, 
: have left a copy of their test data for you at the Head First 
: website^ Point your browser to 

* www, hsadf irst labs . com/books/ hf rail s 

: for a full set of instructions and the data. 

Make sure you do this, or youll tiit problems later on. 



This ii {-he ^blc 
y^ll use het 
sdveriistmfnts 


name 

description 

Price 

seJterJd 

email 
img_urf 
id 

created at 
updated at 


ads 

string 
text 

integer 
string 
string 

integer 

daT.etii^e 
datet 




^ these. arc did 
ioLihns" and they _ 

U e 咖 thoggK didni ask U the ， 


you are twre ， 
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generate 



Put what about the controller? 

The n：odel isn't a lot of use on its nwn + You n^ed some cock 
lhal the da la tile mijdt h l prudum: and lliai's Uie joh of Llit b 

coniroUvr. 

Just like 別 ■afToldinR and ihe model, cnnlrnllers hn\ r e ihHr own 
geueriilt.jrs, l_ T st, the generate controller foinmand 
below to generate an empty controller class: 




Cotttnilkr 


Q 一馨 


you ar? hens 







Flit Edn Window Help 



sc rip t/generate controller ad$ 


This coiimiiuid i^eneratcH a clu 妨 file Fur your cciiiirtjllrr Ai 
app/controllers/ads_contro!ler * rb. H you open 

the filr will] a text editor, youII find some Ruhy code like this ： 


avV^ . 


ok 


丁 W rt 眯 c 

the CoriWh 








㈣ W 

pM 

Cr, 




AdsCont roller < Apr^ l icationCoritro l le.r 

Rc^bcr - the a»d tK e 

^trdlcv na ㈣ are similar 
the toh^oJler uses ^CamelClsc^ t> 
听扣如 a^d A 

logit ^d<s h«e. 


em 3 



\ ads_co n tro Her, rb 


Chd of iht 
dode. 


Well come back to wliat code nced^ to be added lo this da %： 
in ji 3 Ki a lew pages, H , jor now; cool lhat wf didn't have 

in wdEe wy of Uiis Rul>y- and Rails-sperifH： J syntax. 



Gce|c Bits 


CamelCase meaH5 
using uppercase 
within identifiers that consist of 
more than one word to help you 
make out the individual words. 
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scaffoiding 


tlieiBiqre r\9 

Dumb Questions 


Qj Does rake db；migrate always add th& magic 
columns? 

y\l Yep. it sure does 

Oj 

Even if the table is ereaftect by scaffolding? 

Yes If you examined the database tabfe in the 
previous chapter youll see the magic columns in there 
as well 

1$ there any way I can open up the database 
and «xamlna the tables? 

Yes ■ but you 11 need a tool. There s a Firefox add-in 
available called SQLite Manager that will open arid read 
the sqlit63 files used by Rails,. 

I noticed that in the generate model 
command you used ad, but in the genera. 
controller command you used ads. Was that 
intentional? 

J\: Yes. Iri Rails, models alt have singular names, but 
con tollers and tabfes are plural This mean§ Uiat when 
we used the command to generate the model we gave 
the singular name of ad ; but when we used the command 
to generate the controller, we gave the plufatl name ads. 


How important b It to get that right? 

A: _ Ra—se conventions, so it f S 
crucial that you follow them too. If you don't, Rails won't 
be able to sstup your we^app for you properly, and 
some things may net wort. Life is much easier if you 
follow Ihe oorfcvention$ expects. 


Models kave 

singular names hut 
controllers and 
tables arc pluraL 


We' ve created the model and controller, mow lefs move onto the view... 
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page templates 


The view is created 
with a page template 

So whai view t orte do wp need In create? The f \leBay weh app only 
a single 助 d this page will ht* used 站 template for all of 

dir ads on llie For ihh misuii, pages in Kcuh Lirt. 1 oQtii called 

(or sbtiply templates). 

Web art 1 trrealed Irani LtmipJfiLt^ tjy Eli 山 t-cldetl Rub\ (del ERI)), 
and tliis is part of iht' standiird Ruby libiiu y. II sumoone asks ibr ibr ail 
#3, ERb will generate the H JML wel> page Ibi the ad using the page 
template and data from llie modeL 

So how does ERb produce web pages? 


0 ― 翁， 


Embedded Ruby wW 

krom h^odel obiei-ts. 






P 作鉍呼此 is 
inio t^cddid 

program 



^s/g 


p 印‘邮 3 仏 


TW ^ w 此 ” vi i^ 

¥S acs ^ 



0 0 0 0 0 0 


/ads/7 


/ads /6 


/ads /5 


/ads/4 


/ads/3 


/ads^2 


/ads/1 


vw 



you ar^ heir^ 
















scaffolding 


TKe page template contains HTML 

Wlien \t>u generated the modf 1 ：md th< J ‘'mUmlln; Rails 片 eiwilccl 
Ruby ™dr. I lit 卜 view’m Jill It 1 tliirrrenl Lhough. Tlve iipplitadmi 
hivi an 111ML interface, so it makes st L iisu tlial tlir vi«w code 
written in HTML, too. 

Ib crcaic lIic ad InuphiLt% open up d. text ediior and mtt- a Hit' 
called show, html *erb and save it in app/views/ada, licres 
what you need the contents of show. html, erb to look like: 



T>o ihh f . 

命 



So what does the actual web app look like? 


wel> pages irom 
a template. 
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routes are 




■ST DWV 0 


Starr vour server with 

■r 

ruby script/server 

and poinl a brow str at 

http: / /iocalhos t:3 0 0 O/ads/3 

What happens? 


0OO 

Action Contrdter: ExceptiOfi caught 



1 

I I j 4v||0 http://locattiost:3000/ads/3 

企 

~X I 


Unknown action 


No action responded to 3 



Tlie wch iipp t riisim. So what htippcncfd? 

WVve manually cnailed llie hnTr bones nf a web app, bus we haveiA 
ktld Rails how Lo listi ihv new show . html. erb lempliile. 


So how do we do that? 
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scaffolding 

you are here 


A route tells Rails where 

■_ 

your web page is 

Rails need^ a rule say wliit h code to run [iir a pveii URL. ]l r s one 
of tlit very (bv% Limes where aciyally needs some configuration. 



The ruk fc s dial Rails u^ 3 s U> map L [il, p:illiK lo code ajv ral Wd routes, 
Rouit*s mv drilled in ii Hiiby pnjgtain iu config/routes . rb, and 
vve iLCud to add a nevv route for the show, html - g rb umipkitr: 






If someone asks for 
/ads/3 \ I'll u^e the ad 
controller and the show 
tempiote, end set the id 
parameter ta 3 1 


tM# 



, s 如 _ 士 

一 d add 



A ^tionControIler i : Routing: : Routes,draw do I map t 

map. connect T /ads/ : id 1 , : controller => 1 ads’, 

map, connect _ : controller/ : action / : id . 1 ♦ ~ 


map * connec 
end 


config 



routes.rb 


丁 ArC 




The route high flighted here will match 


http : / /mebay. com/ads/3 



ads controller rb 


—to use ads cont roller * rb as the controller code, and 
show , htm 丄 ， erb as the page template. 

But how did this actually work? What happened? 



show.html‘erb 
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routes 


behind the scenes with routes 


^ When Rciils receives a request from a browser, 
it posses the request-path to the routes _rfo 
program to find q matching route. 


map.connect f /ads/ : id' f 

: controller^ 1 ads 1 # : action-> 1 show _ 


IL 







■0 



His the p^gc 


GET/ads/3 



routes.rb 



If the matching route contains symbols, 
then the Routing system will 1 create 
matching parameters m l*h« request 


parameters tobls poromsl，* „], By a symbol 
we mean a sequence of letters prefixed 
with a colon (:). tv g 

'f \ flhLlHp IHfa-A phj PiJLr' ^ 

of Hi^ri 

^ ^ 如 M J symbol ， 


以 cd 


map.connect Vads/ : id r ^ 


: controllers 1 cid^ 1 / : action ^ 1 show 



routes,rb 




pjj - ^ 


Name 


: name 


: description 




❺ The route con abo specify additianat 
parameters that will be inserted into 
paroms […] • 

: controller and :action are often 
specified here # Can yau think why? 


map.connect 1 /ads/ : id', 

: controller^> p ads 1 f : action-> 1 show 





GET /ads/3 


routes.rb 


Phis k dUo pa 妒 ㈣ ] 



Name 

Valu 任 

: id 


j 


: contro 

■% % 

Her 

1 ads 1 

: act ion 

show 
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scaffolding 


o Once the routes a rb program has 

finished, Rails will look ot the value of 
params[;contrdler] and use it to decide which 
type of controller object ft needs to create. 




❾ Once the controller object has been created. 
Rails wl\\ then use the value stored in 
params[:action], to choose the method within 
the controller to tall. 


Naix^ 

v 在 lue 

»■ i i 

■ U 

3 

^controller 

f ads 1 

* act ion 






ads controller rb 


daf show 

* A % 

end 


^Then, when the controller method completes. 
Rails calls the page template that also 
matches the pararns[-action] value. The page 
tempfate then generdtes the response which is 
sent back to the browser. 





IRpliLlS 


j 


ads controllerrl> 
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think 


tl>ereiare n? 

Dumb Que^ions 


Wouldn't it be quicker to generate 
scaffolding and €dit that? 

If depends on the application 』 

MeBay only want a very small amount of 
functionality. If your application needs to 
work significantly differently than sraffolding, 
it will be quicker to just generate the model 
and controller, and th-en add your own code. 

/ Do&s scaffolding generate the 
model as well? 

Yes The scsffaidmg generator calls 
the generators for the model and controller. 
It also creates page templates for the 
standard create, read, update, and delets 
operations. 


Why does Rai 


s need rout& 


configuration? Why not just have 
standard paths? 


/\l Rails always prefers convertlion to 
configuration, excepl when the system 
needs to talk to the outside world. The 
format of the URLs affects how the outside 
world sees the appficalion, so Rails lets you 
configure Ihem. 

When you scaffolding. Raii$ g€nerala$ 
routes for you, but it's still usefyJ to know 
how routes work in case you need to track 
down errors or create custom routes, Eike in 
ttiis applicstiort. 


^ ^ 1 still don't quite understand when 
to use camel case. What gives? 


What ^ort of parameter i$ : id? 

it’s a request parameter, like the ralues 
Ihat are submitted by forms or parameters 
passed into a URL 

What $ a request? 

A. “ , 

A request is what the browser sends 
io the server whenever you dick on a link_ It 
tells the server exactly what path you want. 

o 、 _ 

So what p s a response? 

The response is the content that the 
server returns to the browser, as well as 
other information, tike the mime-type of She 
content. 


J [: CamelCase just means using 
uppercase within identifiers that consist of 
mors than one word. !fs called that because 
the uppercase words look like a camel'5 
humps. 

In Rails, (he filename and controller 
names are similar, but. the uses 

L CamelCa&e' to separate words. Filenames 
use underscores to help you differentiate 
between a bit of code avtd a file 

Which gets called first: the 
controller or the view? 

The controller always gets called 
before the view. 
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Why has the page t&mpEate got 
a phtmKerb file extension? Isn't it just an 
HTML fife? 

A template can simply bean HTML 
file but templates can also contain extra 
instructions that wiH be processed by the 
Embedded Ruby system Files that you want 
Embedded Ruby to process all have V&rtT at 
the end of their filename. 

(). 

Why are the templates fn a folder 
oafled "vlewWad M but the controllers are 
not Jn "control lera/ad 11 ? 

^\" imagine you want to edit an object and 
also view an object. There will be an H edif 
page and a H view H page. But both "edif and 
■uiew B requests will pa$s through a single 
oontroller, So models have a single ccntraller, 
but potentially several pages. That's why 
page templates are in their om sub-folder; 
there may be several of ttiem. 

Oj ■ l ve heard some people talk about 
"business objects’ 1 and ■ 卜 domain objects". 
Does RsiEs have them? 

Yes, because business objects and 
domain objects are just other names for 
model objects. 



夕 scaffolding 


♦ 


辛 




MeBay>. compeniion a]i'eFidy lias a Rails application，which k using 
this d routes: 

map.connect 1 /shows/ : title 1 r : controller => ■shows 1 , : action-> 1 display 1 
map.connect 1 /cats/ : name 1 , t controller => K cats 1 f i dcLion=> f show T 
map*connect p /gadgets/ : Lype 1 , : controller => gadgets 1 f t actiofl=> 1 show 


Clui you 'sun'k out which U'ii 3 plale lik 1 will he it^crd lo gt'neraLc 
the H JML for each oi the given L RLs? Draw a line to connect 
tJie LIU, {o die pafjc leniplate that wLli be used, then wiite dowii 
rhe nnmc and value [)t the parameler that will be extracted ironi 

earli URL, 



❹ 


❺ 



liws ea^K Uf{L tKc 
f^c tmpiaic fi! € , 

http: / /yourbay. corri/qadget.s/display 


Parameter Name: 


Value: 


http : //yourbay*com/shows/cats 


Parameter Name ； 


Valu^i 




http://yourbay.com/cats/gadget 

Parameter Name; . . . Value: 



views 



cals 





dispEay.htmL rb 



^haw.htmf.rb 





gadgets 



di^p^y r html T rb 




show.htmt.rb 





disptay.htrnl.rb 



sho^v.htmP.rb 
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wha fs my w 。 


♦ 


夺 









MeB^y s competition already has a Rails application^ which is \mn^ 
ill is set of rntUesr 

mapconnect 1 / shows /: title 1 f ^corrtrollei ： => 1 ； shows f , : action=> ( display 1 

map * connect 1 /cats / : name 1 f t controller => _ cats 1 f : action=> _ show r 
map - connect 1 / gadgets /: type i controller => T gadgets 1 , : action=> ■show 



Gan you workoui which pag^ template File will be u^d to generate 
the HTML fimu h of ihe pivtTi URLs? Draw a line io ronnetl 
(Jit 1 URL Uj ihv p^ig J e Leinpktii 1 [hal will lx j Lised ，\itcn wrilt b duwn 
the name and value of the parameter that will be extracted from 
each U RL, 




TV ha 

a ^ paumetw in 
the revest 


http://yourbay*com/gadgets/display 

Parameter Name: - ， …: 办 ??■…" Value: ..Al s j?Uy, 

The f i 

o httji : / / your baycom/shows / cats 

: 拙 e 


Parameter Name: 


Value: 



hL tp : //yourbay * com/cats/gadget 


Parameter Nam^: …” 〒 ■ 叶 ?,■… Value: ”:明咖七 


display-html,rb 


show.html.rb 



display, htmlxb 
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show.html.rb 



























仙 scaffolding 


, a I ■ \ 二 •二 


Tqst Drii/s 


Open the hrow&cr at a couple of pagt s ： 

http: / /localhost: 3000 /ads /3 and 
http://localhost: 3000 /ads /5 


丁 hfi p3y 5 h^vc r\0 b 七 k ! 




t f kic^ Nistf' 3>OOOV ftr^ & / 3 


|P> 


•% + ■’ ^ help jiUu liiCMKMj.tKf 1 




Naoif ： 



nit 


LU 


4 


C '<■ + * ^ nn p f /ioc alfipst J 


llrS 4 J I 

Vrltati 
^tlkr lil: 



yet ^ 








Naim: 


Frkt ： 
Seller Id: 
Ctuill; 



The ads are MariM 



p 办 w 在 w 


Why is there no detail on the pages? Was it the 
routing? The mode!? The view? The controller? 
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the view 


dBtB 


The view doesn't have 
the data to display 

Look back at show, htiril, erb. This file is 
used to create i he pages for each of the ads 一 
and rhafs exactly what the template has done; 


□ 


app 





views 


<head> 

</head> 

<body> 

<p> 八 

<b>Kame i 
</p> 

<p> 


< / title> 




〆 m n .</ b > 叽 ㈣ 州 dcsfiipt! 

<b>Descrtptior, / ^ 

</ P > d address? 

<p> 

<b>Price!</b> 

</p> 

<p> 

<b>seller Id:</b> 

< 0 ^ i h^ e j oi(l ^ 

</body > 

</html> 


■On 」 


show.html.erb 


Aklinu^h \\v pui i\w main skeletal parts of' Lhe 
HTML in pi ace- the labels, the body and head 
sections — ihcie were a coupk- of things that wei t- 
missed out We haven’t specilled: 

What data needs to be displayed 


WhBre in the page that data needs to be inserted. 
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scaffoiding 


So what should the page show? 

We iwrf ihi j ad page in display llif 1 dalti tor Lhe ad number ^wified in iIip 
ITRL. As an her^V the URL for ad #3: 



http : / /1 oca 1 host : :_K)0 0/ads/3 

地 he?, d^ - the ads table, aU tKai Wd^.. 


tk rtcoti Wiih id — 3 



id 

name 

description 

price 

seller Id 

email 

img url 

1 

Typewriter 

Old manual typ r *► 

71 .95 

54 

dhsinTTiet * - .®email * *. 

http : / / ■ww, f ot “ ， 


Football 

Some strings f.,. 

>74 .02 

45 

mrtyggooglema« ，- . 

http://www.dai... 


A 


HcjQs^hfiaci 


Desk 



y moth-、. 


K:ilk desk 


go 



297a 


4900 


: a thy@hr>tmri 


I ndy@ a1lmail 



//saloon 


ht tp : //picasa 




The first thing you need to do is to tell the model 
to iffad the record liom ihe ads table in the 
datiiba^f" with an id number tha^s I he same 
iht* id uumbci in the URL. It the user asks for 
llie pafre for ad #% the model needs to be loki 
to read the rctorcl with id - 3, 


We weed to display the 
data in the right place 

Reading the data's fLi^l !vAf llit- stury. (Jure 
the modcFs. road ihc data, k needs to send the 
data to the 1 vu ； \v. Thr v\vw tlien needs t" know 
where to display the data in each of tJie pages, 
Eadi of i \w lietds in iIip record needs tn hr 
displayed nexl 1< ^ ihe t nrrr.sptnidiriR lal>e!^ in 
die wob pages. Plus you need to use the value in 
the img_url column io bscn an image oT the 
sak& hem LntG the page. 


So which part of the system 
is responsible for asking for 
the appropriate data from the 
database atid! then sending the 
data to the view? 


Moosehead 


4 


httaiMDcalliQstiJMOr^ads/^ 


Io _) 叱 head 



liglitly moth-eateii- One ol tlw antlei*s is lw)krn and 

ihere'^ ii Ntran^e l>uzzing ^mnd b^hiEid llie 产 yes." 



^ rse %if| 

dai^ 咖 



id 







kiil]iv(5)h« liuidLcorn 
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the controlfer 


view 


The controller sends the ad to the view 


Lei's sc?< fc wliat Uit* codt. in tlitf txrnLixliter will l"(_k likv tmd 
h(m il \ull work: 


❹ When the users browser sends a 
request for o page to the appl feat ion. 
Rails calls the routes.rb program to 
decide which code needs to run. 



Q 


O 



0 

routes, rb 


❹ routes.rb examines the path af 
the request and decides that the 
upplrcation to carry out 

a ''show" oction using 中 he ads 
cortroller. It also creates an : id 
parameter with the value l, 3 M from 
the requested path. 



tci ^ ^ £rta J^ s 〆 





routes.rb 


'rouies.rb tefli 尺 
io a ^ds 

^Oh-t^reNnr 





I've created o 
parameter cafled 
: id with value n 3 v \ 


of 







从 £ 济 




th 


❺ The controller sees that the :fd 
parameter is set to "3”，so it 
asks the Ad model to find the ad 
object with id = 3* The controller 
talks to the model using a method 
colled o "finder". 




m. 




\ 


Tk 






Ad* find (par ams [ : id]) 



















o The Ad model reads the record from 
th€ ads table with Id = 3 and sends the 
result back to the controller. 




no^/ond scaffolding 


lS Tcb^ 0 I 


Ad, find (params [: id]) 



The controller stores the data for ad 
#3 into memory by assigning rt to a 
variable catted @ad. The page temples 肀 e 
con see th 总 @ad variable and so it wtll 
now be able to use the ad data when 
generating the web page. 






method h with a ware 

na 伸 e d ai/bow “ 如 ' « 


ti 


TV 找 a tonVroM 

xWs be 


llie completed code in 
ads con troller _ rb needs 
inhiiHe a method ralleri show 
■TiiUrlies ihe natm a iil' She : cicl 
DiuaiiifLer t. rtf a led t)V routl^s 


Type in the completed 
controller code above 


/a^/a aft-broll crs/ads_t octroi 


levro 
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from record 



Rails Wmi the record into an object 


Wtim Rails rt^sfis itir record from ihe datahase that malehes thf id in Elir 


URI ^ the child Ironi {liv rerurtl is touv^Tt^d in la iin object. Thai ol >]cr('s 
storrcl in memory imd the CLuitmllcr a^^igiis it the name @ad. 




■ *WllHEh H-tCll ； iy-i43-3-n F . 


bLLlt 


£e ： t- 


IzJll 


1^1 


nmmm 

r/tww. 


ITCT 






Ut _ 

ransKH'rl-zMil H ■ 


hx.mii f wv I loi a _ _ 


aari! *?Mq|.^rip,,. 


•■IbHju.i1 


I. :iT. rfact^y^L«9Bir d ■矗 


it El PJf* 


lit w 


»0£d aniiujJ. c^p 






Ancgi-p-^t^ti 


Rul iirrcord \va^ srWTal fieldti wslh dat；3 in earh ont\ How does all (he chila 



de 蘑 cjripti 


pl：lc 


@ad 




eEnaxl 


mg 咐 


^/len'CrtrV 


stored in ii siiu^le obj^cl/ 


Thf nns\%'er i^i lhaL an ohjpc'L raTi h^ve several attrihatex. An atinbiae 
like a fiukl in a record. It Ilis a name mid ci value. Ho Ik"ii Rails reads the 


description value from the record on the database, it stores it in die 
®ad. description attribute ui the @ad object. I hc same thing for the 
id, the name, the sellci -id. and so on. 


In thh 'oy, thr @ad nirKlei nbj^rt exactly 



matches (he reenrd in ilit' rlaiahitse- This 
h usfitil bt 乂 mist* thin memory object 
will he visibl 疤 io the view code. 


de sc rip tii 

P: ice 

@ad f seller id 


qsGhtBa 


ghtiy moth- 


E>esk 


Milk desk 


棚 0 


123 


id / 

native / 

da 涅 ci: ip on 

pi|i.ce 

seller j^a, 

email / 

img__i4r^ 

1 / 

Typewriter/ 

Old typ,.+ 

7ll95 

& 4 / r 

dhainmett^eTTiaiC* - » 

http;//www ^fot ,* * 

■^i ■ 

Football | 

Some sfrings f ■… 

74 扣 2 

45 / 

ificXtySgoojpema..., 

http://■ wjw-dai" ■ 


：3 thy@hotniai 


http://aaloo 


dndy@allmail.cr- . . http;//pi 亡 asaw 
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The data's in memory, and the web page can m it 

The pagf* template (show - hi ml - erb; hn\ jusi sent stnught back lo die 
broustT. Firsl \[ ^ts processed b) ihv Embedded Riiby ERh 5 

and tlmt^ wliv our 化 itiphik，liad iliat . @rb file c\tc ； nsioii.. So lei\ take a 
doser look at how KRI> ivads objects from memory. 

ERJj recid^ liuxnigli the l^riiphiti' lookiiijr foi ILllJe piece's t?f L v mlx tk]t:d Ruby 
code called expre^iems. Ail expression is siuroundcd by <%— fj]d %> and 
ERb will tvplace the expressjn with ks ^iduc. So LI ii fmcU: 




%> 


somewhere hi lhe wAy Rail^i will n'plat r ihh expr^sBion wlih ?. liflbj e 

returning the jja^e lo Lhe browser. 

But whai we trfiffy want lo d(n is giu ;it ihe v^ikie^ in I hr @ad nhjpfl frnm 
ineniorv; like ihk 


<html> 

<head> 

<title><%= @ad,name %></title> 





<b>Wame :</b><%= @ ad * name %> 

</p> 

<p> 

<b>Descript ion; </b><%= @ad - description. 

i/p> 


诠 -pWe with 



<P> 


<b>Frice:</b><%- price %> 

</p> 

<p> 

<b>SeIler Id:</b><%= @ad*seller_id %> 

</p> 

<P> 

<b>EjnaiI : </b><%= @ad. email %> 

</p> 

<p> 

cimg src= f '<%= @ad- img_ui:l %>■■/> 

</p> 

</body> 

</htnil> 

Befoi v st i iidin|T I hr pa^e Iwk, [Uls replies all the 

<%—. - . lays with llieir object Viiluei. 


■iru. jj. • 

MinxrhfAd 


D ： SUajiLtly mQtlircMm. One -af thv ajstkrf u broken and 


I hu'n’i 町 niL^r 


kir?i 


Price? 


SrUrr lDi 





So doen it work? 















test 



To try out the system, the tblka at MeBav have used their data entry 
system to insert datJa into the R?iils database ， 

As soon as the data is stored \n the database it becomes a\ aliable (hlough 
tilt- web. So if ^onienne requests /a.ds/1, / ads/2*, and w mi, rliey see a 
[iage Uial ^ I'irrn 只 enmued hy Uie iippropriatt 3 data in i\w data!msp. 


I ^ - b I I H I Illlll - 

rlUR|H I a 


Prwci WKS 
U 3 n>(|lj ， Vt 

liJJUUj. kMOf i 

¥ 


iMi _Mi ■老 ■li* rilihs H mvl 

I Hl^Ci||r1liii a.i ； 


fvnnnrn 


McBay ^ ^ 衽扣 

Congratulations! 




»r -'*■■■ 


Nii 


Vh-^ b«l WiMh ■ boffita ihoxh ■. 

IMc h 7 1 

Spflbf IDi 


\buVe* just rreated your first hand-era! uv I His appluiiUrsn! Ahhnu^h 
][L 10k a liltk longer ihail Lising sirafTokliiig, you were \ti control M 
every sEcp. \\ liat^ you Uikcn a peek under the hood of Raik 

and learned about &ome of the things k does: 




BULLET POINTS —— 

■ Routes tell Rails what code to run 
when a request is received for a URL 

■ The controller uses tfie id from the 
URL to read the correct data from 
the model 

■ The model reads the database and 
returns the data as a Ruby object 


The controller gives the object a 
name in memory so that it can be 
found by... 

■ the page template, which uses 
embedded Ruby expressions to 
insert the data values into the page 
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scaffolding 



P ⑽ 1 Puzzje 


MeBay want to display information about sellers 
at /seller/:id. Complete the controller and 
the page template with the code provided 


dtef stats 

=Seller * f ind( 

■ +■+ + « + + +■■ ■寺 B9+l^» 1 I 1 + + * I + -E I + + _■+«■■ + + * * + 

end 


<P> 

<b>Number of sales:</b> 

</p> 

<P> 

<b>Total sales value:</b> 

</p> 

<p> 

<b>Average price : </b> 

■ « a- v « 4 

</p> 





■m 


Not«：€ach snippet 
from the pool can only 
be used once! 


@seiler 


i- id] 




total 


J. es 


<% 


— 


C d sel ， Ier,num 


<% 


<%- 


you ere here > 
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get out 


(ji 



fm] Puzzle 制 


id m^btr £he URL 


■ J ㈣ ^ , 

\ Vl Jr def stats 

t scU£ T 

dat^ se ’ end 




is adci 


—h 3 Tor /a 

加峋 “ cr 南 e 3 


<p> 




S- 


trb>Number of sales : <r/b> 

</p> — 

<p> 

<b>Total salas value : </b> | <% 

</p> 


Sseller, nujii sales 


P L 

- ——一 




^seller,total_sales 

_ 


QD ， 




<p> 

<b>Average price:</b> 
</p> 


< 


gseller.total sales 


IT| 「/ 


Useller-num sales 



B% 


so 





r tr 

average safe 叫|叱 7 


w ^ a ^ 



㈣ t need fhf$e 


ihifpeis 
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scaffolding 


There's a problem 一 people can't 
find the pages they want 


K\'Cij though tUcrc arc pagei for ever) ad in the databa^i:, tlicre's 
no ea^y way for people to find them* 



If I want to browse through the 
ads on the site, I have to type 
in URLs like /ads/1 and /ads/2. 
That's nat exactly user-frrendly. 


To liclp prople slc wiiiil Ltds there are, and 
help them skip Lhrough the ads to Qnd ihc 
one s that are mte rating io them，the Me Bay 
folks have asked for an index page tn 
display links m ril] ol die pages. 


Ijyc^rnr 

FirndrraD 





Afipk TsVffJkii 

^hJIULSQ 



D'naujJpliiini Fhiiih Kriiiga l 『 a I Yi、l 

Prtr?? 

Liu 通 U_lT. ■, i/iJui l^aiiJL^ubi 





「i T. i l i WImjI 

I^hvi>h Mc««hrftcl 

ll#»c#lf]qh3flB-l^hlv Lh^ jnilm u tinjh« jiiiI 

ibprr B i ii xo^pip Itiifci^i .mml hHiinH ntw #wi 

rrtirpi 押阳怎 

fifll 时 TCh r A 

LiilnlL LiUii 'uifll^/iijyl.LiMTI 


-今 V 


Ef you wanted to create a new pag 色 called Index'^ what would the 
route be if you wanted http r / /mebay .com/ads / to cali it? 

What would the code in the controlfer be called? 

How about the page template? 

Route: 

Controller code: ... . . Page template: ... . . 


^^rpen your pencil 
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create an 



tfi&p&i arB no 。 

Dumb Questions 


Serpen your pencil 

Solution 


If you wsmt^d to create a page caEE^d "index" what would the 
route be if you wanted http: //mobay ■ com/ads/ to c^tl it? 

What would the code in the controller be called? 

How about the page template? 


Route ； tn^P-ionnctk V5ds/ f i lc<—> P ^ds J | : attioh 二 >’inde， J 

li i ■ 4- fc ■ ■ + + ■■ i i« + t *i i il + + * ■ + + fc ■ # 寺 + I ； ■ ri ri 1 + fa i ri + + B i v + + 41 i- + I; ■ ■ + + B ^ + + i S + + B H B : + 4s 4 i # - + ■ # + + + i - + + *B i B 8 + + fc ■ d: !§■■§■ i _ ;!■ + +■ ri ri 1 + ■#• ■ ri • + H + + ■# S* ^ ■+ ► ■ 

Conlrolier code:. . .. ... Page template: htf?! 


What is an action? 


The action is the sef of operations that a Rails app 
Ccrries out in response b a request from a user., TTie action 
parameter specifies a name for the action. All of your code 
{Ike the method in the controller, and the page template file) 
uses the action name so ttiat Rails can find them. 


Can I use any database with Rails? 


All of the major databases - like SQLIteS. MySQL and 
Oracle - are supported. Plus, most of the time you don't need 
to write a lot of database-specific code. That way, you can 
sv/itch between database systems without breaking your 
application ： or rewriting a ton of code. 


Languages like Java have primitives as well as 
objects. Does Ruby or Ralls have primitives? 


l\l No. There are no primitives in Ruby』Everything you 
deal with in the Ruby language (induding things like numbers 
and even bEocks of code) are objects. 


IsrVt a paga template just a fancy name fora page? 


l\l No. A page template is used to generate pages r but rt is 
not a page itself. Pages are generated from page templates. 
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scaffolding 


Sharpen your pencil (again) 



There «are now two routes; 

map.connect f /ads/ : id 1 , : controller=> t ads ^ : action=> 1 show 

map*connect r ads/ r T : contro 丄丄 er => 1 ads f T :action~> 1 index' 

Which page would be displayed for each of the URLs? 




All Ads 

• ] y pilfU.lfiJC 

• 118 jj I 

• ^.11 ii I ^ |b- .11 | 

*■ IJupt tJ jr I Jim 

• Sinelaii i" S 

• F.iI-h-t 1 

■* S>ajmuE_il 


/ads/3 



index,htmLerb 


/ads/something 


/ads/ 



h there a probfem? (f so, how would you fix it? 


Sfr + + « ■ l| ' 
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confusing 



parpen your pencil (again ； 




Solution 


There are now two routes ： 

map. connect f / ads/ : id 1 1 : controller=> t ads 、 : action => 1 show 1 

map*connect f ads / 、： controller^ 1 ads S : action-> f index 1 

Whkh page would be displayed for each of the URLs? 


The 11 / ads/ H fjth will hn^th bo|jk of -the vwtdt 士 
ncedi to be so ^ only 





!Hau»i Uciwhruil 

Jilpwra4p4lHTii ^ylilh mulb-rrilr-n, £ d llir Aiuk^n □ lii'-isi'r 

riwi 1 、！• rtnnfi Irmbic "mvi 3 brhiiHi ihr 

Twi^vm.2h 

iMMt Illi 
Email: U 山 


show.htm}.erb 


Routes run in priority order 

Be>lli of I lie ro Liles matih tht j / a ds palh, li.mh nViukls iiny anihijriLilv In' only Lui 叫 [he firsl 
iiuik liin 叾 mulA_.su thi! rouiL 1 ^ iiL-cd Lu hv ix'-isrdt'rrd io gel rid ul' (.lie L(iiifusioi：L 

miip . connect _ /ads / f , : control 1 er=> T ads T , : act ion=> r i ndex 1 

map,connect 1 / ads / : id \ ^controller=> , ad 3 1 f : action => 1 show 1 

I hese arc tiie routes Raik will use. Now you need lo complete iJie oxlc. 


¥ 



: Add these routes to 

l config/routes,rb. 
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beyond scaffolding 

Routing 

This week's interview: 

What 3 s life like at Rails' main traffic intersection? 


Head First: Aii ， Rnutiny ； Sf» kiiul you tn s[>iirr us a 

few moiuciiB of your valujl sic linic. 

■ 

Routing - Nf 、 l lie nets ■ mtrf)3ln … nds … Veah, thill s tb-r- 

one. 

Head First ： Rousing^ 

Routing: Woab *■ stimd buddy. Reciueat coming 

LhrLVLigh …… Ik tp [ 

Head First: tilcarly ynu lia\e a very l>u^yjoh. The thing 
is, ahh^vi^h you h"ld a very ]inpori：ini yn »si uiLhin ii Rai^ 
j]>pSk'iitiiin：, sonu fc >\}W ew Liiisuri" uluU you do. 

Routing ： H[.y -1 ain’t in j«>b lor the iTcognUbn. li:i 
dim I and io smv. Thai's me. Ini lifci 3 a f ns Ilk rop, sre? , \ 
ret I ups ： ： L cimes in “imugh that H^or ⑽ t thm a : J 

Head First: What - the port? 

Routing; Ydi 』 VVI»;u is i"m itik sn'iT? Pc>ie !^h)0 i ^wy 
thert 1 . Tlie retjut'si tomes in from ;l vvt^b Ftir I 

tkm■ s kiiriAV- -IrTs sav / donut 5 /cr<9cim. 

■ 

Head First: Y 行？ 

Routing ； liiu Raik don't kn"u wlmt piece nf mk' tn run 

l ， r"vidmn iiiiswcr Uj UkiI. So Jk: comrs U) mr imd \ 
look aJt /donuts/cream nad 1 cheirk It 过 gainst this sheet 
of routes 1 got lie re … 

Head First: Olu dieres qiLtite a fev%: 

Routing ： Wnh. So I go tl"un liM and luuk iIip i\vs,i 

rm 扑 ihrit l<ii：>ks kinda tin 1 s;.imc L as / donuts/cream. I 
mi 兒 ju li:icl … /donuts/ : f 1 avor^ s^iv 

Head First ： 1 \ i-m rous<^ prniy similar But bm tl w 
thai help yon dircci I he iTqiiesM" (he tr_rieri rodt?? 

Routing ： \\v\l ru ry a fiiik st mnirs in w iih ptipi ruin k Inr 
me [n fd] [ml. A set of li^ims aiid \"Lillies callcti die rrcjuesi 
pat a merely. Sec? 

Head First: "h Li U,S (if SlLlfi'u 

Routing ： Ymli. All request^ have ihcm, pauai^s [ * * , j 
thevW called, S< i- ] look at the route, and n idls me rhat 

M 

every pal h thai matches / donuts / : flavor needs If f 
usr llie donuts n mrmlk'u say, vvilh the display a(.lio]L 


Head First: That makt s 

Routing: Si：_ ] add mow 1 hi 呼 to slir params [ * " J s 
\\kc pa rams [: controller] \viih \\w mtiie donuts 
cUid parsing [ 1 action] wiilfl ihc value displ^y-.^ 

Head First: … and Rails uses Uiat to chtjosc uhm code to 

run. 

Routing ： I«xaully! Y"u Irani Fasl, kkl! l^Ds Gh 
1 see. J need [u use a ciom <_■ out roller, Korsootl^ 1 shall 
create one 

Head First: 

Routing ： Mayl)e noi Ibrsof^li. Hut uliatewi 1 lif fc he 
fcnmvs !te 1 seeds h 1 nmr 3 r]oni】ts mnirolkr objcrL Anti 
because params [ t action] is set to display, tmee 

the domiLs fnnln ilItT objrx't c fc \i^is, hr 1 mils liar d 丄 3 pl ay 
melliud ail il. 

Head First: Whm abrnu the : flavor vnii 

.if 

in the nmte? 

Routing: Oli. iliai. Udl if ilu ix-quest 
was for / donut5/cream and lhat inatdies 
/ donuts/: flavor」just add a nos her pumctrr wiih 
paii^dm [ t flavor] = 1 cream r + So I jusi xerord whiil 
Wi-ib askt j d [vt in casr iiV (o ihr vodv m lin/ 

ctiiiirollef later nn. 

Head First Thanks, Routing it’s been a ]v;il … 

Routing ： Hvy. ^tuiid ba<. k a intunrisl] Hnti). h\ Lhr 
nrn'nus ^uy who nluays df inble-tlirks liis hypcrlitiks ..， 

(>ne at a lime! One ai a lime! 

Head First: Tkmk … 

Routing ： m'l mention it- Listeai, getting a bit busy here 
no\\\ \\ hv don E \ou mw e aloD^and see whas happens m 
i lir R fc Ht of Llht h r c\pp. Ye;ih, jusi dnuTi flirrr tin ihv MU 

think s(jme hew code into ihc ads c ⑽ ttoller"* 
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the contra Her : n 


To get data into the view, you will 
also need code in the controller 


The model s already in place, and then j s a route lor ihe new 
rontroJltr c:nde ymi iu s pd. Hut Ls tlmr Hnythinjr else? 

WelL ws — you’l] need two things, I he index j>age needs 

( ndt 1 in th^ rant roller brrause Ms looking; ai tots of' ad«„ 
Lind ycmll n^etf fi new lo dhpU)' Lluii in llie vieu'. 





Nhui#i ?ik<whpiad 




U^jAJT 
Ulra xi I _ 


ITtMilrC-ulftL UHa 8 iA Ebr jLiUrfifl i 
I y.iMUL a Iuajla% u.uml LkIiukJIlI 


fiDk^ia 
e . 


F 「 Jj ， 面 



>/ou nttd to write 
e<?dc ^ tof^b^lkr 
to deal with all t^c ads” 


But what else? What needs to 
happen to the controller? 


touih 棚 



㈣ Ml 

M*fc jjIt.iiI 

Ih4 


yo^ f U 

㈣ te As 

P 吵 



l>»ir i . up am 
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index.html.erb 





What would the controller have to do for an index page 
that \t wouldn't need to do for an ad page? 
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scatfofdmg 


Ah index page will need data 
from ALL of the records 


Tiie ad [>agt fc only needed data Irani a single recoi'd, hut 
whnl abfuit the index page? Thai will nerd io dara 
from eatli of tin retiords in (he entire ads futile. But why? 


Look ai rliF design for the index. It needs to create links for 
all o|. ihv ads pages, ivlurh rmn.s it will nt^d in know the j 
nanit' a】id id nLimber n( every fid on (he sysLern. 

Bui isn't lliat a pmhlms? lar we’vr only read single 
records nl ii time. Nc.hv wt a nwd to read a wlmle bundi cif 
record ^ all at once... in fkut, \w n^ed uf tlif records. 



T?TP™nnirr 

Hiwr4p|iiiHJ I Nd m«wii4hTT™rnn- Mpm ■pmn ^ «-s |ijl 


WuriM bt^i viib s boiilr maE-ii 

Prau:T|.l^ 

Swlbr in . 31 



So how do you read more 
than 刪 record? 

The controller is only called once lie fare t\w page 
is (Ihpliiyt^d so ;-iIi at ihe n r cords net*d to bf a 
completely beibrt: lUe view h railed. 


biiiiflEli Jumrlu;n _ mjil B ■ ■: fid 







ad model 




ads controller 



How do yoy think the controller will read the objects 
from the model and send them to tha view? 



ad indew page 
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find 


Ad.find {: all) reads the whole 
table at once 

11 li're's another \ r crsinn of ihc Ad* find ( ■ - O finder ititithiHl. uhirh 
i cturn^i data nlwiil mrv ivcuid in the u hulr ads l“l>k: 


/ 


yW 

咖 5 wetVKwl ^ 


def index 

@ads = Ad-find(:all) 


end 



TKis reads all of \Mc 


liut hnvv ran t!m< w"rk/ Al’U'r aEL whvu you vmv ivuding a ^uv^h ix \<nxL 
(Jiings were fairly simple. Y"u passed the model an kl mmilxr ， and 山 r 
inorlH reHumi d a ^ Jije< t cnnmininpf ill of ihr ilmn i" [hr n»w wish 

I hr ffnTrspojidiit^ id. 


B^t in av yi >n clou s knnvv li"w many icmrch ynifiv ^ning tn reacL Wi»ti t 
I ]vM mean you ntnl some /mriffh rmiipfex rorlr? 

Inrtunislrly m Riiils in^kie^ iviiding t wyy rrrurd In a ml]Ir vtny 
similar to i a ungk rsbiect. When you call Ad. find (: all), the 

ni? nlr| rrnims li single object that TOniains dnut |; _r m a ry _?mrd in 
[he tabK\ The coiHmll^r iim iLSsipi ihr oljjrrL lt> n single Viiriublt 、 


Hut h[_w i ,i Au Rmils store i\W ni' Else Hmi [hr an imkn <avii numbt 4 !' ol rows 
iusicle a single cihjecL? 


+ r 对晰 


a ■ 

■ 晷 

: Add this method to the : 

: controller ， : 

p ■> 

M m 




11 cl(w []m 1)> usin^ a ^p^cial lypf j d ul)id” 



ad model 


rv 


4-|irC 


6 


M 卜 “ (: a ) 



A —k 

u ta^k 



ads controller 



(Jaiis^Ad. t i nd ( 
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Mcn'or^ 


pnd 

rmsm 

ilflj -ri p!. :tm 

prsi--" 

mUd: 


IJKJ Hfe-1 

p i- ■ Ll "W 



Did ^umuil itjT ： . j . 

1Tb 35 

31 

«S:asns::j suil - • ■ 

tlE CJM """W ■ III 1 ： ■! . ■ 




1 碼，： 

i=. 



1 ■ 


Iimr miEiwrw r. 



ttD'aeb-iiJ 

Ellgfefcly K ： h-.. 

.IJ, 

1-1 

2fiLh^ALDL3£ll.. i. . j 

tl C12 : MlMD - 


Ewi 

Hii；: - 9n … 

4!03^ 

T:f ^ 

anjcr^t^llw^Ll . c - 1 •- 

_,i - |,T， -ii . 一 

tir^i /-'putaav--. 


Lj- ^ 1 --^.J 
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scaffolding 


The data is returned as an 
object called m array 

Uitr ilian juhil n：!luni an obj^r! 山亡 nhtln lrt>ni a single 

record, the find method cii'iitcs loin oJ ubjuts — one for each 
record — and then wraps them up in an object called an array. 

"I lie Ad „ find ( : a 11 ) fmdtT returns a single array ubjet .4 llnit in 
turn cc^mainE> many model objects a& there ajv rows in ihv 
database table. 

1 he conlixjUcr tiui ^iort r tilt.' [uray object Ln mcriKii y uiLh thv 

name @ads. Thar niiikcs ii simpler fur ihr pagv templatr, boc4ansc 
Lnsreacl oi' looking Ibr an imkiiawn number of model objects in 
nirmory the EerriMlatf 1 only needs to know the naine of (he arrn\; to ge\ 
arcess to all of the model oI>jerts + 




hz t p[ f / www _ fot,.. 






pnez 疆 


Typewriter 


Did rr_a:rja 丄 


T L. 9S 


Fcs-&tba I : 


strings f. 


WooBehead 


SI i1 y svoih 




I>ssk 


Hi Ik desk, — go 


4 3 Q 0 


: :!； Carxnin 


Beaded ioor oiia , „ 


dhaejnetrgemail.. 


http ^ / J w»nf. da i. * 


htT.p : //aaloon.. 


https//picasaw. t 


http: / / ww £re A 


http: / / vnof. dlf. 


**m IT 




kaihy@h.Dt.iraii . 


andyBallaiail. c ^ . 


dairngbotfflai 1 .c^ t 


123 


773 


ahe r t zifd if f c rt 


Si 


lai i 


Z lac t 


Apple Mcwton 


Still vQEks! M. ,. 


311,06 




c L i ve 0 ^ ^ ri tl a i i：, „ 


But how do you get access to the objects, 
once they’re stored in the array? 


you are here ， 
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arrays are like i/.iyn 

Ah array is a numbered 
sequence of objects 

riir @ads amiy : stores tiie model objfrls in a ol' 

numbered skslK ， be<riiiiiiii^ w iii\ slot (J. [ lie 1 1bj c r c ts tlutt lut 
coiitaiiied in each of the slots are called the array s elements. 



@ads[0] @ads[I] gads[2] §ads[3] @ads[4] @ads[5] @ads[€] 


\\m ran read E he incihiclual ekm^nli ： uf ihv arr：iy l)\ Lisin p 
tlit s iiUniljtT i_r (lie sksE llmi cun tail is ll:u 4 rlcmrnL 


@arSv[4] 



Hitf ot\ 6 tt stortd Ih slot T 

of arr^Y is 仏 c table 

Vp^M wtH U 二 


Hie slot$ tire aJua\ s mimbercd u|_m_aids fmm slot iK ctnd 
arrays l\ui be big as needed, it doesn_E rcaJJy matter licn\ 
many records ihcrc arc on the iahk\ they can all be stored 
inside a single array object 


tiiereior^ no 

Dutnb Questi 


ions 


Qj 

Why do arrays start a! z^to instead 

off? 

lt r s historical Most programming ： 
languages have anays, and in most cases 
their indexes start at zero. 


Q ： 



Wafcli it! 


When you put something into an 
array, does the array keep a separate 
copy? 

j\: No. Arrays just keep references to 
objects stored in memory. It doesn't keep 
it’s own copy of an object, it just remembers 
where they live. 


Arrays start at 
index 0 


That means the 
position of each 
element is its index 
number plus one. So Pads [01 
contains the first element 
@ads [I] contains the second, 
and so on. 


q ： Is the array really an obj&ct? 

j\: Yes An anay is a full Ruby object. 

o- 

How big can an array be? 

There is no limit on the size of an array, 
so long as il fits in memorv. 
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scaffolding 



Insert the objects into the page, as if there are just tiesejhree rom in the database 


Excise 


id 

nmmm 


pric* 

«*1Lar id 

l H^lBfe ： Ll 

iims uzrl 

1 

Type^rltar 

014 mini 1441 typ” - 

I 7 i r 9f 


j ihaci^rL^-suRiai J. T r 

!rm^p ■ / /uyv. d ” 


t^&Ll 

*■■* Ji J|5 ifll B — n 1 

7^ . ： 

^5 

~ir ： r^yOQ'.vo^i't：^^ ,,. 

tjp; // i ,,, 


KCioE-sJtiead 

Slightly zh-.^, 

25 


Jcaihy?r. : r,m.ail. .. - B 

■r^® - ■ - ._ 

i\~ rp : / / Ea _ c on .... 






叫 dr 1 


KJU' 


Write down whet the HTML index. htrnl *erb mght look like 


w 代 


H a pp 


views 



ad& 


index.htmt.erb 


! Oi 


iere 
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use array 



Insert the objects into the page, as if there are just these three rows in the database 


id 

nmm^ 

d4scEip'tian 

pric« 

id 


im? vul 


t Tjir«»s»=ij f* I r -^r 

rtlj l+i n p 11^ 1 T VT f 

71 E5 


'lliaLia-^T. L^sjsia i X.... 

T"i 'E.tp : / / WaTJ . f . t.,. 


j. 4 

：； ' 





n 

1 

3cti^^ ^ X-'C 131^*3 T ■ ■ •■ 

■ ^ p Wi* 

45 

siartyd^di - 

ll t-tp r / / '*iH Qfi iL ■-- 


HooE^nead 

Slightly jel] : h- . 

*"&7I 

5t 

1 ka=hy?nt osail“ “ 

— « 

ill tp : / / 55.1 con.. . 4 , 





Write down what the HTML index* m tml. orb might look like 


■ ■■ 


^ ^ We? did. un, ^ e 

1 y° u ^ 3 ^. 


If. 


<h« d > 广 di ^tihZV^ 5 ^ 

<iit[e>^ll Adi</ trblc> As ton^ ^ m -fj h 

</hc^d> 

<body> 

<hl>/^1l |ftds<A/> 

<l*l> 

<\\><k h^ci-=■ V^ds/<IdsCdd %>*><%=- $AddOl nAr^t %>^/a></li> 
<lixa Kre-F—Vads/<%= dadstllid %> M X%=- dadsCilname %></ax/li> 
<|i><3 Wei— J1 /^d ^/<%— @adsCllid %> ><%— 3^<hLZl n^tnc %></a></li> 

</u> 

</hcdy> 

</h^nrA> 


I'm no 肀 sure this 

exercise quite right. What 
if there aren't exactly three 
records in the table? 



ads 


index.htmi.erb 



In practice^ you won 1 * know how many ads 
there are. 

The code ah"w will only display 3 ads. But what if there are - 
nr or ^,(^)0? You doii'l vvjfiiu lo haw In change liie tempLiir 
evevv time an kn\ is adcJrd of ft:moved frniu ilu! tUdalnks 匕 


You need some way of writing cade that will 
cope with any number of ads in the database* 
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?oyon>. scaffolding 



WotiJan't it be dreamy if there was 
some 州 ay of handling all the elemerits in 
an array regardless of how many there are 
But I know it's just o fantasy.,. 


SS 





foops 


Read all of the ads with 
a for loop 


A Rjuby for loop lets you mn the same pioc< of Ruby code CAvr 
and ova again. It can be used to read ihe elementi? in an array; 
one ar a lime，and i\wn run a piece of code on each piemenl, 

I he piece ol c«xle that’s mn each lime is called the loop body. 
Tlie loop body will execiHe Ibr each eJement of Uie array ， ii] 

咒 qiiHicf% dialling uilh 

etemcp't Will be 

ad tKc 1 。外 




for in @ads 

# Do something with the 1 ad ? object 

I 

end 丁 k ihden-ted tode 



In tli^ ^ibo\'e code, each time the body runs，the rui'rent dement 
in ihr ci：TLiy is given the iianie ad. _Sn ad rulers lo eai li oi' tb^ 
Al! mode! nbjtitls, mid uiside liic loop yyu tiui iums nil uJ ihv 
model objects attributes: tlie details of the ad, such as the name 
or the description of the thing being rakL 



Ri^hi now, we nt^efl lo genera re the H IML that wDJ n^cate a link 
lo thf 1 ad's web pagien But the HTML h generated by the page 
template* How can \\v use a Ibr \oop with thal? 


86 Chapter 2 












scaffofding 


We need HTML for each 
element in the array 

Kjr cads ad object iti the @ads arra^ ue need to generate a 
hyperlitiji m HTML. 



■a~3 L" *i m .iiU m M *^*y~** 


AH Adt 


AU Ads 

TypcwrhtT 

Rmllia]l 

M oust 1 head 

Desk 

Dooi' tliu tain 

Apple >kmn 

Sind air C5 


Diamond 



ixa hj ： ef- M /ads/Q l, >Typawriter</a></Ii> 


<lixa href= t Vadsyi M >Football</a></li> 


<li><a href= M /ads/2 ti >Moosehead</a>^/1 i 



Wc ran use a tor loop to do this. I lie loop would alJovy us to work through 
fN]rh r>i" thf ach^ our rit a time. \\ we used the loop bn-dy to generate the 
HTMU vvr could rreaLr links for each of llie ikfls: 



for ad in @ads 


/■ 






end 


TVi\s \s 
real w 如 


i he pi obiem is lhat wc generate wd ! pag^es by putting Ruby expressions 
inside page templates. The ffJML m the page template controls when the 
Ruby t'xpTi's.uans are (ini w warn U \ do ""- otfin' ivay round. "Wt- 

uaiit a Ruby for luap itt cfiidrot when i\w, H~TML is gmeralt ■丄 


So how can we eombine control statements like for 
loops with page template HTML? 


you are here > 
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templaus 


Rails converts page templates 
into Roby code 

When wanted ui gel nbpri values: inlrs <1 page 
wc ins^TLed therri usinjr <%— * , _ : 


<%=@ad* name%> 


ERI> (I imbedded Ruby) getirraics a web page liom the 
template by replacing r-arh ctf thr expressions with iheir 
vaJues, ERb does ibis by cxmverlin^ i lie entire page into 

RiiI jV imle 』 

Jr 


Imagine this was all you had \n a pagr templaie: 

<txtleX%= @ad. name 


%X/title> 

Pa^c 



ERI> generates Rul^y code io print nui each expi L es^ian and 
each chunk of H I ML, So the template code above gets 
converted inln ^onu-thing like Lhk; 


print 

Mm 

print 

print 


ff <title> rf 



@ad-name 
， f </title>” 



ERb ^herated 

e<fdc 





The Ruby code h Lbeti ^xeruted and the output h what gets 
st # nl owj ih-e iir[wi>rk U> Lhti ImnvstT ： 

1^T/V1U 七 

^ todc ' 

<title>Moosehead</title> 

If you want a template ta generate code for 
each object in an array，how would you want 
the Ruby code to look? 




^OWSCt^ 
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scaffolding 


loops can be added to page 
templates using scripflcts 

Let’s ahniM page irmphurs lor llie mnnu tiL U yt hi uviy- writing 
【I i)iert b fotU 1 m ]>rint out HTML !nr mrh rlenmsL in an muy. w\i;i[ 
would (.licit rodr Jwk like? 11 liii^hi h K：»k a IhtJv like lliis: 


£ol ad in @ads 


print 


cli ><a href =' 


print ad,id 
print "■>’ 
priot ad，name 
print 11 < / a>< / 1 


ih ls todt 


end 


U r tUTchu t]ir<HiEj;h ihr iirruy hikI prim mlm HTML :， ml 

txpmWis lur i m h t femenl. Su I;" wc \ f ( inly seen lAih gem-j-aiing 
print comniaiKls, hm llir for Km tp isiVi a pi int i timmaurL So hmv 
t .m wr pass ERI) diuiiks Riiby vndr likr i\w for 

Fhe is tu unr scfiptbts 

A scripld Is a tag confining a piece of Ruby code. Expjvision tags 
an- surrmmfled by <★=**, =b>' but ^niptlets arc surrnuiKled liy 
<% . . H %>+ Scriptlets don*t ha\e the = sign at the start of them. 

To see hovv rip lie w >rk, lei's iiikc a look at a pag<^ template in 
produce the for loop code above: 


Theses nv 

a_f 

l 


二 th 


c 


c 


;dri rtJct 



pM 


if 


for ad xn @ads %> 




<lixa href^ M /ads/<%- ad.id %; 
% end. %> 


/ 



%— ad, n ame %></a></1i 




end of tKe sfrifilct 


Am 




Object values 
are inserted 
wit It <%= . ♦ 
But coJe is 
scried witk 


1/ 

%> 


in 


<% 


* 


%> 






I his o ust：-s s^ripikns for the It m 卜 ping code and expminns \vhm k 
iTiJues will b«- inseried, Let r s see whai the index page template will 
look like il \vi- use srnj^tlt'ts t,o loop ihrun^l) tht j @a>ir ： an: 巧、 
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add some 



On each pass of the loop, the 
page generates one link 

This is the juii'll 1 >p using li>r the 1 
i ndex . h Lm 1 - erb 


<html> 

<head> 

<title>All Ads</title> 
</head> 

<body> 

<hl>All Ads</hl> 

<ul> 



<% for ad in @ads %> 

<li><a href=Vads/<%- ad. id %>"><%= ad.name %></ a ></li> 
<% end %> 

</ul> 

</body> 

</html> 



W fiej] Kmh prort^ses the lempiat^, tUf 1 HTML ai ihf* Inp ?md ih? bollom 

uT the file will ju^t be ouLpul as you’d expect- The interesting pari is in the 
middle of iJll 1 page. Each piii.s ul Lhc loop will ari [ FJ ML link lo 

the matching ad page. 
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scaffolding 


So what does the generated 
HTML look like? 

(magint 3 there art 3 - jnsl these \hrvc ads m ihe database, 

Thai means Uic controller will pmduce an @ads 
array containing three ohj^cts. ^Mien the page 

Lrnipbilt h loops (JirnUjrli (he ariMiy it should 

produce HTML that looks sointrlltnig likt 1 ilvis: 



So it looks l]kr ihi^i will generate just enough H 1 ML fbr all 
of the acls in the- database. If ihere arc inc?re ads created in 
the database, a larger @ads array will produced and the 
t^mplai^ sh< m]d generate a lont^pr pit a < e of HTML. 

I hat、the Uieorv, Now that iht route's been created，the 

■ * 

controller action^ been written ， and ihc index.html -erb 
lemp|alt b s in plact fc h^s Unie to run Lht* tode. 


you BfB nere > 
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test 



mil (he route to / ads / in place, the cnnsroDer reading all 
of the ivcords wilh ftd，find { : a ] 1) s and ihe tempi ate 
using u. si lipilet lu t^inbtjc! a f ot -]«xjp l !mi reads ail oJ ihv 
mode] L>l>]ects from the @ads amty; It's Lime to test Lhe iicw 
index page. 




iSfUr rariJa-ailm.'DH-Di civ uikn DLlnin«d 
I N.ipi^g gijfciifcf harl fci- Hi - 

hir« : S?>ISIS 



Ipft.hi I ii ■ ■■ -ii 


Well done! 

1 he applkalion is complete, the new ^vebsite is launched,,, 

and you did the whole tiling without scaffolding? 




^-^BUUiT POINTS - 

■ You can display data for a single record ■ You now ha ye the power to write a ton of read¬ 

only applications! 

■ You can dispfay data for all the records m a 
table. 
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scaffolding 


You just got an email from 
the folks at MePay... 

The [uniUioiialiiy o( the siie now mat dies exarllv whai live 
orijriri^l sptc cLsketl ft >r. Ev'ei^ytj lie's re idly pltaseci. Then, an 
lhe morning that the ^itc^ due to launch, you got im cnmil: 


Dudef 


You did an incredible job with the site, WeVe really 
pleased at the way you were able to build it to our exact 
specification. We.d heard that Rails applications always 
looked snd worked the same! 

Bjrthe way n here s a design for how the site wifi look. 

We think this m\\ be the final look of tfie application, but 
i f tHere are any changes, well send them through later. 

Thanks egain for all the hard work >} 


There 7 ^ a sample web and ^ set of styleshms and 

^itLache k d tn ihr [t ran t br tha* hard lo changt' 

lilt 1 IcMik f)T the appHcatiori；, cun it? 


蜃 

骨 


■ 

■ 

« 

* 



fewnlaaJ 

辛 


■ _ ■ 


■l 


Download Ihe stylesheets and images from: 

ww. headfirst labs ， com/book^/hf rails 


« 4 


_ r 





You could just modify the page templates so they 
look like the sample web page from the designer. 
What’s the problem In doing that? 
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style 


Put there are two page templates … should 
we change the code of each owe? 

There are two pag^ templates, so ii' you just change the HTML in both 
(rmpliU+'s 10 niMErh she MeBay sample 1 psige^ yon 31 have duplicated 
the code. In LliaL iietiJly a bi^ desil Jhtre? AiUr cill, ilit?re are only two 
iypt'^ ot u r fb pii^r^ in tlir ^ili\ Tlutrs noi . 1 ^ bail, it? 

Vhv pixjblem h EluH [lie a|i])laraEiun may gmu r_ 、 n. time : uid iu.quirt 1 
ms hi 1 (tMLiLiirs find pLi^' Lrinphites. Ajid what tiboul Lhat comment about 
(In- drsi^u p A) ilicni^in^;' l lir 13 a jp; dmrs yuu du[jlic ； ih , 11 iv k>uL 
(he mvtx L [^laccji yovi \mw to mainly in tlie same H IMl,, (>wr lime (]u_ 
application could Imrrl work miiiiTiain, 

So what’s the answer；* WelL Uir obvious answer is to remove rht 
diipljcadon. Most web sires have a standardized look across most of their 
riiE-y ha\^ lx>ilrrpl；ne HTML siirroimrling (!ip main 

rontpnt of eaHi 己 

So you st>me u' ； i.y ai Helming a super-template : one single 

dial w]\\ ronti> how a !jmiip * if "itifT ienijilaies will look- 


Rails Principle* 

DRY- Do^t 

Repeat Yourself 


n w 巧 
^ aWcadf 


y°^ *^td 

TKc sup 七—如 ^ 
to^Vd Aat He 

icfnfltbei loob I 如， 




0 


indOXphtrnl.erb 


show.html.erb 


A layout defines a STANPARP look for a 
whole set of page templates 

ForiiiEiaLch; jiBt such a suiter-Lrmpiate rxists in Knils. cind il s 
CiilJed a layout. A i“y"ui clrfmmn H 1ML wmpper ii n rdl of iht- 
trmpla" 、 JiHon^lng; u > 3 |>nrticular nuxlel. 

Lct\ ht)w it'll work with rhe iicw desi^. 






scaffolding 


Ba 辟 S^R-T^HPiate 0>pe 

This is ihc example HTMLpagi 3 Imm ihr designer 
nl\vr il'M Ix^t'ii i/miVtTted iiUo a lavoLEL. 



Ycjli iiL j t j d lu pul il in tht? ri^iil phtL't 1 by ^aviu^ - it ns: 
app/views/layouts/ads - html_erb 

I'hat name tells Raifa to apply the layout to all of the page templates belonging to the ad model- 

We vtr ]>ul in a couple ol expi tis^kms [o specif) r a stylcslst a eL and gi\'e ilie paj^t' i\. Litk s based upon 
the cum：itt ccnitroller name. But much more unportaiitly; tlie layout contains this tag: 

<%= yield %> 


Is there a problem with inserting the output of the current 
page templates info the layout? If there h t write it below* 



Sharpen your pencil 
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modify 


[s there the problem with inserting the output of the current 
page templates into the layout? Write it down below: 


Tht t^Ph^laftcs doniaiti too mwth — they al^rtady ail tHe HT/VIL boil^rpEaie the 淋 


Sharpen your pencil 
、 Solution 


Yoo need to REMOVE the boilerplate 
from your page templates 

Look ai tht 1 existing index.html - erb 
It ali'cady coniains HTML boiJcrplatc 
elementii, like rhe <head> and ihe 


厂 


<html> 

<head> 


But now tlias their s a layout piw irimg the boilerplate, you sired to 
down the templates so they display jusl Lhe rtiairi page ronten l : 



<title>Ail Ads</title> 
</head> 

<body> 

<hl>All Ads</hl> 

<ul> 

<: -for a.d iji @ads %> 
<11>< 4 href^ rt /ad3/<% 

<% end %> 

</uI> 


tilt 


<hl>All hds</hl> 

<ul> 

<% for ad in @ad 3 

<Li><a href= rt /ads/ <=& - 

<% end %> 



命 

Da tbi^ 



Eid. i d 


ad，name %x/a></li > 



Edit both the index html.erb 
and show.htmLerb files to 
remove the boilerplate HTML 


■ 

V 

# 
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scaffolding 


Put what about the new static 
content MePay sent over? 

Si> far only grrh.rated tlvnamit r> nvien^ (Vnm a Fliiih 

;ipp. [ J iL fc ll\ nuk h rwrylhiiiy lias brrn nutplH pat^e U.isipliiiles. 
Hut wiivn yuit’iT ^pcciiyiii!^ \tie co^rruiic^ uf a sitr, you ollcn 
nt'L b c：l static tfmh iit likr stvit'sheds, hmtgt 、 and jaittSaiph, Bui 
Jiow fli j ^hi int hide static irmtem iti 1 hr- applies(iim? 

Rails seB aside a folder jn^t for static !3c^. Ii's callrd public. 


When you < rcate \hc a implication. Rails already put qnke a icw 
fih^ in thf! pulilic Infclei； member ihe \}y^\ iinn j y<m siart^：! 
ihc Raik applir;ii!nn and looked ai ihv Iroril jiajinr? I lir lilt% ii ir 
thf ^Lindard welc-t mie all live in Ehe pub I i c ftjli.lei'. 

Most Rails applu niions store their images -it；d 

]；naSn ipis in public/images, public/stylesheets 
and public/javascripts re^pt*(Lhdy. 

Once you’ve ^aved the extra images ancf 
stylesheets from th« email f we should be 
good to go_ 



public 





(n>aige$ 



bg.png 



bg Footer, png 



bgHeader.png 



logo.png 



java$cripts 


> 



stylesheets 



defaultx^s 


_ > 



*my_style.css 


you /iere ► 
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mebay looks great 




Tesr Dri 赃 


Opeti up a hrowsfr a nd look at ; 


http :// localhost : 3000/ads 



As you bn>U"SL j liirou^h Lhc site, the slaiidard took will bi 1 applied Lei llO 
uf ihc pajt^s. And if van add mon. tomphiies later, or U you modify the 
HI ML in the iayoiiL the applicatioa will main tain a consistent look. 
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i scaffolding 


Scaffoldless Grid 

Fill In the grid with the answers to each of the clues to reveal the 
mystery word. 

Ciue lor the mystery word: 

A reason you would want to manually create an application 
instead of using scaffolding. 






i 

n 

n 

□□□ 

匚 




2 








3 








4 






L 





LXJI LIU 








6 

7 

8 





j 

L 

L 









1 

11 






i 

1 



^nz 





tol 11 11 





Clues 

t. <% i? %> 

2. You could use a page template for this 

3. Converts the data from the database into Ruby objects 

4. <%= i-Jwhdt , am_i ? %> 

5. Migtit send data from the model to the mw 

6. Update the data structure with rake db ： 

m # + fl *■ ■■ a 9 i il- + i r ' A A "i ■ i- ii 

7. If you are creating a simple application, you might not need this 

8. Reads object(s) from a database 
9„ Every route has a request 

1 Q r An object containing many objects 
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get the 



Seaffoldless Grid Solution 

Fill in the grid with the answers to each of the clues to reveal the 
mystery word. 

Clue for the mystery word: 

A reason you would want to manually create an application 
instead of using scaffolding. 







2 ii/mm 


w 




^imrpigi 


4 


lc|g||N|T|[F||0 


£ 


>< 


L 




£ 


F 


El 


io [aKIMa 


pIIrTe 



i 

c 

1 


， 

r 

i 


E 


m 


H 


F 


£ Is 


0 




3 


M 


F 


E 


0 


fl 


m 




Clues 

1 T <% @what,am i? %> 

2. You could use a page template for this 

3. Converts the data from the database into Ruby objects 

4. <%= @what, am_i? %> 

5. Might send data from the mode! to the view 

6. Update the data structure with rake db ： 

7. If you are creating a sirripJe application, you might not need this 
B. Reads object(s) from a database 

9. Every route has a request 

10,, An object containing ； many objects 
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scaffolding 



Tools for your Kails Toolbox 

You’ve got Chapter 2 under your 
belt, and now you f ve added the 
ability to manually create read-only 
applicaficins to yoyr toolbox. 


f^a»U Tools 

y ow taw a 

d e^troller 
r 士 y str, r^ ⑽ crate 



Ruby Tools 

〒， y_^ay i S a ^ 

eleihfivt is jivch 

^y_drtay€Ol 

Can — ihiroujh aW i), c e \ entC ^ 
eleK'Cht In ^y_away 

养 Do wiih tk^etd 

€r^i 
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3 inserting, upcifttlng, 如 cl deleting 


^Everything changes 命 



Change is a fact of Nfe — especially for data. So far you've 
seen how to whip up a quick Rails application with scaffolding, and how to write 
your own code to pubfssh data from a database But what if you want users to 
be able to edit data your way? What if scaffolding doesn't do what you want? 

In this chapter, you'll learn how to insert. ypdate r and delete data m exactly 
the way you want. And while you're doing that, youII be taken deeper into how 
Rails really works and maybe even learn a little about security along the way. 
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mebay 


People want to post new ads online 

Ffe<jple b>\^ thp MeBay silt% inn ihtTE^s a pnil*tem + Because MeBay 

wa* iu!rv>>us :ibtnu i-lc hsiving tu<i iTiut 4 h access iu Uie daui ， S4 h lk a r^ 
\]i\vv to [jhonc in deuiil^ ul th^ir Uciiis to Mt'Bay and wnit while the 
iwsktn ad min is I rii tors m 爐 tinv ad^ U n 1 lln i sdW 、 A、ihc munlxr "i 
}xop】c -ending in iuls lias giuu n. has the wan umr. A loi of pcuplc 
are taking their business to other advertising sites now, 

So MeBay has relented. After mmt dbcustioo, ilirvVc decided that 
pefiplr hIuiuIcI |>r alknvcrl to post tlieir own atls un the lining a 
|)apfe Ih^l Inob like thh: 



dcsi^ ^ktUh 

■hroin 

/ 
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inserting, updating, deleting 


You already know howto build an app 
that publishes data from the database 

Thr ads on !y gn nne a way in ihe rurrenl applir^lion ， [ hr ad mwds arc 
fn)in ihe database by [\\c modt j L wtiidi osiu tTl^ diem u\[n ad (}bj( ， i，ls 
thaL are diet] st'iit lo the view by lliu CDiUrtjller. [t wcirbi like thbj ： 


Tllf rnodd dOftVCvt {: hf 




^ obied^i 

fj 


model 



if 








th€ d ^U^e 



controller 



i™ 


dUCEJpXiU 




pel 


£UuJbuT 


hJ. 141 :/ ■ _ 


Bucvlo^irg 丄 nu_ ■ ■ 
^t-h^Sfrl^fFPP Li r v -1 - 


5EMB JFLElCLefl 
Sligti tl-y vpt 


u. 


#1-. 




Hull 4nv.-lt ~ 


^n4r4HlluLl^t ： r. 


tLCZtAll 



method ^ I 
ai>d 



topiate ibe 

vanaMc a^d 

displays the 

七邊 web 


^^harpen your penci 


I 


1 










Draw a diagram co show how you think the new sd-posting feature 
will work. Be sure to fndude the main components of the application 
and add notes to describe what each component wi9l do. 
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saving and 


^rfwi your pentil 
k Solution 




㈣ 




VtTMU 






od 




] 





\ 




Draw a diagram to show how you think the new ad-posting feature 
will work. Be sure to include the main components of the application 
and add notes to describe what each component will da 


三 == 二 : 







Cwb"ollw 


丁 Ue ^odt\ tViCP 
the objttt ^ 

3 no retold m 



Wodel 





Saving data works just the 
OPPOSITE of reading data 

data Lo lUc dalaba^ 1 sifnihir lo publishing yds Jmm the databasei 
t fc Xrq)( h w(>rk>i the oLIilt vuiy nutrjd. In^Lead a page k fc nipbie Ut 
ifisphiv i'tu till, you imd ii p 叫 v Lmipl.ilv t< 卜 siibroit .in tttl. Inslcad nf h i 
【unimllrr action nR L ih"d tt> scikI m\ ad tri a pa^e, you need a caiurtiJIer 
mctliLK：! \u iciir! data ir"m t psi^c and rum it hiUi an nbjjrrr. Ai\d ii^lriid 
rjf the : modf 1 1 reading a record and converting il into an object, you uped 
the hichI ， ■ 丨 in mnvfrt nn objeri iin<> a nrWrecord in 山 「 diUnlm 
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inserting, updating, deleting 


You need a form to submit data 
and an actioM method to save it 


You nmi ii nfW pagt 1 Ifinph.itt 1 La i r^ali 1 i\w l FFML form. Bt'tfiusr ii 、 vil] 
be n&cd to enter new ads, ue’il ad] this template new.html *erfa. 

The “New ad" page will need to appear at 

http : //mebay-com/ads/new 
and 【 lit' form will be &ubmhk!d to: 

http :/ /mebay ^com/ads/create 

So w' aho urerl ro creaif 1 <1 new route tn 

routes.rh. 




views 



new.html.erb 


"th<? f&rm、 

uses i«aie mtlM 

ihc ads dohUler. 



The ,T create ,f method in the 

controller: 


Sharpen your pencil 



descriptigj 

price 

@ad l seller id 


The controller method will need to create an ad model object 
from the data in the form. Can you see an attribute in the model 
that does not have a field in the form? Why h that? 

Missing attribute: 

■ 邊 ■#!#■■§■ <1^ i i ir •¥ •k « 4' + *li ! i ■ ■ b # + i! l; i ■ * + + h ; i fl + "k *■ i K_ ft 1 . + + h ! I i ■«■ « °i 

Reason it r s missing: 


eitiaxl 


ujtI 


What will the route look like that will connect /ads/new to the 
new ■ html« erb file，and /ads/create to the create method 
m the ads controller? 
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ids are 


^barpw your pencil 
\ Solution 





The controller method will need to create ars ad model object 
from the data in the form. Can you see an attribute in the model 
that does not have a field in the form? Why h that? 


Missing attribute: TKe id 


■ + ■a++iBa++&iiO- 


Reason it s mEssing:Thc user doesr / 七 defiide wlha-t ihc id is — ’土 will 

_ u ， tr _ [_■■■■* n w 獨 ■■_ it "画 a sr v _■■■_■■■ up _____ 瀾 ■■ r t t 1 ■■瀾 

bt auiornat'it^l[y ftcncirated by the systern. 

■ i* + +iT^_aiBd!ii i «+hh+ + c feri #■§*+& ruMm ■ ■ ■ ii in "■ r r B ■ !§■ + -fa c B *#fi + ,i fiai++itapHil''l. F k a feBi!l'+iiKi++Bii + ii'faBi a H'!B8i! 

What will the route look like that will connect / ads/new to the 

new - html* erb file, and / acs/create to the create method 
in the ads controller? 


V Ads/o\ I 




iKc method 

The URL bt ialkd ■ r _ 

〔 („ .the f ile ™ 

'…… l ……见…丄 - …兄 .. …，…胤. 


The top of your config/routes.rb file should now look 
like this: 




Tf routes should be added h> tKe b>y 
c4 tKe file ^ frtveni them 
叶 ^ith tKe Vads/iid' rwte 


ActionController : : Routing: : Routes . draw do |map | 

map.connect _/ads/new 1 t : control!er => 1 ads 1 r : action => 1 new - 
map.connect 1 /ads/create 1 # : controller^ f ads f f : action—> r create T 

map, connect 1 /ads/ T f \ controllers' ads r f v action ^ 1 index 1 
map, connect p /ads/ : id r , : controller ^ 1 ada 1 x : action ^ 1 show 1 


It looks 釘 ke form^ and objects carry 
a lot of the same krnd^ of inf ornriation. I 
wonder if there’s some deeper relarHonship 
between o form and an object? 


108 



There are close relationships between many parts of a 
Rails application^ 

Alter all，the mixlcl contains the data tor the application, the view allovvis 
the us^er to access that dam, and the coniroller provides the logical glue that 
connects c^emhing tageihen 

But tlicrc some special relationship Ixrtween a form and a mode]? 


























inserting, updating, 


deleting 


Are forms and objects related? 


A pan inmi live fjent fc r^il^rl id, the fw\ds in i h< a [(jrm m：udi ihe 
allnbuLra. of ;irs citl objecl. 


C 


ho maUh in the 
不。 w lor {he id. 


MS 



mmw 


' •- _ I 

; 打 ■ i ； 



Mew idd 


hr 


■■i 


Ph» * 


tmm 


囑 _ 


Ai ^onic point the applicaiion is going to ha\ e to transl^r 
dciiLi ht s twt'f j ii lhe (hrm ;uirt morfel，I [te narne Held will 
rnalrli lu a iiiime LillribuLc^ Lhe dt^ ripdon field n ill 
matdL tj n description attribuu： rind so on. 



Whal if the model creates objfc'Ls with default values in 
ihe aLtiibutesi 3 ShtJidd ihe aotkt lliat gt^ierate^ tilt 1 (lirfhuh 
values in the form duplicate tiie model code? 


AferalL when (lit 1 d^ilA in llif Jorni is reLeivt j d bv Llit h 

jH 

contiiollor, iliOLdd ihe farm LreM ihe fields as indiiidual 
values? Ur should all ot the fidd vakm lx- associated 
togctlien, like the auributes oi an objects 

Could Rails make use of the relationship 
between form fields and m model object 
when creating a form? 


)u are 打 ere ► 
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rails models 


Rails can create forms that are 
associated with model objects 


Rail^ tan use a m.[xld c^bjecl to help create a Ibrm, That 
means Vwo things: 



l iie values in the form Jiclds will he set to the values stored 



in the amibmeH of cite dad objea, ITiis doesn't make a lot 
oi ro tlie ad form becausf 1 Tiew ads are bhnk + 


1 he form fields will be given names thal explicilly associate 
tUmp fields wilh a model r>b|ecL 


So h«>w can a name associate a lidd with an abject? Let’s 
look at what it would mean [or the ad form. This is the 
HTML rJiat will be generated for a form that’s based on an 
Aci obifTt ： 


1 description_ 


\ price 


fj seller i { 

ri 


1 email r 



li&g 一 Qjj 1 







<b>Name</bxbr /> 

1 '^ated Vj I ^ npUt id ^" ad _^^ - name-adtnamf 

如 ㈣㈣ /b><br ^ PtlQn ，_ —^^ 3 c ripti o n r-></text, re ,> 

< 1 叩叶 id -- ad_sener id - name ^^ r ” - - 

<b>^aiU /b>< ^ /> ~ ad[SeUer - idjT ， ^yPe^text- /> 

<±npUt id - n ^d_emall^ name^ad [em^i 11 - ^ ,_ 

处 > 1 叩 url</ b >< br ^ 1 11J tyPe= textM 

<JnPUt ldj，，ad - lmg - Url，< n ^e^^drimg_ U riT- typ e = ” tej5t 



« 办 《 弦它 n 

Comparing the field names and their 
matching attributes, how do you think Rails 
wilt present the form data to the controller? 

You have a few pages to think about this … 


Field names 

Object attributes 

ad Jname] 

name 

ad[description] 

description 

adfprice] 

price 

ad 1 seller id] 

seller id 

ad[email] 

email 

ad [ling url I 

img_u r1 
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inserting, updating, deleting 



Form Object Magnets 

It s time to write the new.him kerb page template. 

The <% form for %> tag h used to generate a form 
using a form object. Complete the fields in the form using 
the magnets below: 


_ u + 

wVe 減 3 

<hl>New ad</hl> 


Fwm ta^ are 
二 m Ou^t use <% i 


so dw i 说 


The cbjrt-t 

tAc tv^rm i$ 

h^d <?h. 


<% form for (@ad f : url->{ : action^ 1 create - }} da I f I 

_ ^ ^__ 

<p><b>Name< / b><b r /><%= £,text field : name %></p> 


<p><b>Description</b><br /><%: 
<pxb>Pr ice</bxbr /><%= 


TV afitioh tUai the (orm 

w,ll be Submitted 

S ⑽減 Cd 

_ Uk, 

%></p> 


%> 


</p> 


<rp><b>Sel ler</bxbr /><%= 

%></p> 

<p><fc>Ema 丄 l< 7 b><br /><%= 

i 

%></p> 

<p><b>Img url</b><br /><%= 

%>< /p> 

« 寺 ■ 9 + + F B ■ # 謹 4 + + ■ 9 ■> + ，夺 + HP P fl ， + ■# i ■ + 4 ■ P 9 屮 + P ■ ■ 今 . 麵， 4 警寺 P ■ ^ + + f 

<p><%= 

%></p> 


<% end %> 
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form 



Form Oljject Magnets Solution 

It's time to write the new,html.erb page template. 

The <% form for %> tag is used to generate a form 
using a form object. Complete the ffelds in the form using 


tlie magnets below: 


hl>New ad</hl> 


WrtK 巾 

taas, the f 。 … j be 
ji * i*c M 
tiW^d + * 



n 


c 


tvuld 


forjn_f 01 (@ad! : url=> { : action=> 1 create 1 J ) do | f I %> 
<p><b>Name</bxbr /><%= f . text field : name %></ 


<p><b>De3cription</b><br /><% 


2 兹 ST 


<pxb>Pr ice</bxbr /><% 


</P> 


<pxb>Sel 1 er</bxbr /><% 


<p><b>Email</b><bx /><% 


<p><b>Img url</b><br /><% 


<p><% 


<% end %> 




伞 o 


r l c e ^ ^ ku 

, 77 1 ih ^ ^ ^ss io 

ihe id. 


_tL^f Save lh is code to a file called 

■ app/view$/ad^/now /htiictl, ^rb 




Why doesn't the form contain any 
fields for the id, updafed_at and created 
at columris? 


tiiBTB|are no 

Dumb Questions 

Those ftelcte will be autonnatica%filled 
in by Rails. The id will be automatically 
g^n^rated number and the updated at and 


createat fields will be given timestamps at 
the time the record is saved or updated in 
the database^ Those are our magic colymns, 
remember? 


112 




















inserting, updating, ；3 deteting 




Tesr Drivo 


The pa^r template for the “upw “ Inrm is in place and k should 
^neriiLe HTML hi lilt 3 same wny UiaL we ^fntfi aied i\h 3 lK sbmv" pagt^s, 
Thene , & al&u a route in place that connect the ££ /ads/ne\v' ? path !u the 
template. So let's sec if it works by going to: 

http : //localhost : 3000 /ads/new 


^ n o 


Action ConimHer: Exception caughi « 


i c j 

_ 1 +1 

■的 hi! p: / /local Noil 1 1000/ a{ls / n ew 


RuntimeError m Ads#new 

sriowmg ads/new.MmLerb wnere ime 92 rarsed: 

ill f\ii. itXXji nLiX^Ii tfuuly ain1#v 4 Xf |uu iiKitr 14 nil, ukir U 

Extrdeled source (ground line # 2 ); 

2i <1 jCora—forflAdriurl-Mi.etion.^crtaUDdojfE %> 

Si <^<&>Najsie</l»<br /><_■ t»t«xt tix/p> 

{ i /><! - f »ioni_air«a i dooof £pi i^n %5--c/p> 

5 i <o><b>Price</bxbr /><l^ field ipricc %> 


The page crashed! 





Something s gone awry with the form page. 
Look at the error message that was produced 
and see if you can work out what went wrong. 
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nil means 


The mi form object has 
not b 娜 created 


The },)n>blem h caused by the @ ad object. By defkulu a variable like 
@ad is sf t to a special value called nil, which mea as no value. H 
Held is Srt b i U> n i Ij. instead of hrhig sn Lo im Ad objerl., il wori'l hiive 
iiUribiit-：'s like dad. name, @ad. description, and ^i> on. 


If @ad doesn’t have attribute docs iha* i -usse a probleni for the form? 

\tm be I 1 The form h t>ased on the @ad objecu and l lie t;_rm accedes 
r a 3 c]i r>f I hr nhje(.rs aHrihutt's tu genr the inioal vh!up« o| tlie Hrlds 
in tht^ lonn. Bui as soon as lht a Eir&t ^itlribuLe is siall^d, nil is rfUinierL 
Ltnd Uiat ClUI^s an L'l ieii'. 


So how can we avoid this problem? 





@ad = nil 




<hl>Nev ad</hl> 

<% form_for( L ^d, ： ui ： i->( ：actio ^ >rcreate 

<P><b>N aill e</b><br /><|= f . texr fipl , 0 

xc ^ fleld : name %></ p > 

P De3cnption</b><br /><%= f ^ ext - 一 ~ 一 

<P><b>Price</bXbr />< 蛘 f ~ description %></ p > 

Uer</b><br ， >< 笔； f.text fi e i d ■ ■、 

<P><b> Ema ii< /b > <br /><% , aeld ' ；email ^； %></p> 

、 P><b>img U rl</b><br /><%= f . text . ' P ' 

<P><% ^ f ，如 bmit -Cr e at e - i></p> _ … % ></P ： 

<i end %> 


^ tKe 


_i a 


Vui 


II M 

；he atirib, 

^ Bui 

13 set -(» hif, iki 

cv-ro^. 
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inserting, updating, deleting 


The form object needs to be created 
before the form is displayed 

Wfien the pnge with thr form h jren^riiied, the initial \aluea of 
each of ihe form fields will comt a fr<im of iIk* fillrihiiLes of Lite 
ctssoi-'icitjed oljjrct. 

Can you think what the problem is with that? 

The problem is Ehai before thf I'orm ran hf* 只 rnerated，the iww ad 
ulsjsxl In already exist. Of mrst% unlil llie user t'ompiele^ llie 
details ol' (lu ： .id, liiu object wtm'l be lo [lie dLitabasr- Ijut wen 
so, the ul>jett nteck Uj I »e created kftm the page template h called. 


TKc Vdrm II be 
sen 士 ba^k to tkc 

user h> dofti^lexc 

tkf devils a 
the Ad, 

c 


❻ 


❹ 



The user reque^te the 
fi new ad_ page. 



ised 

of 




几 ““ 咖 ly c-rcaUd 

f d 。— dt — ii 

^ bit 

扑 c objed-t Ohfy U 

… to tr € ^ L- 


A new blank ad object 
is created. 


new.htmLerb 

new htmL^rb generates a 
form for the rtew 3d, which 
is returned to the user 


續 SC 5 “ 


Where m the application would you create 
the new ad object? If Ws a template or 
method, what would it be calied? 
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new means 


The forms ad object will be created in 
the new action of the controller 



The forms ad object needs to he ereated before 
the new.html.erb page, 會 emplcite is run. 

If you create the object in a controller method called new, 
ihis wifi be run b^/or^ lire 1 new, html ,erb tfmplalf fc is railed 



The browser requests 

http： //mebay, com/ads/n^v 



The M n©w +I method in the 
ads controller is called. 


If 
catkd 


a 





def new 


^ihod 

u hew ' the 


c 匕 


end 




So how do you create a new ad object? 

Ad , new rt h lLirns a iit.w nbjet t Uull you ctm assign io lht K 
@ad \ ci] iabk\ I he new obicit v^onl lie sawtl antoniiiitkiilly 
to the database, bin vou only need it in memory where It 
can be u&ed (o generate ihe HTML Ibi m. 



The "new 1 * method 
creates the new object. 


Me 啉 。旷 y 


-tt：" 



def new 


tKii 

lro/|^|r 


@ad 

end 


Ad-new < 







Now that the objec 會 fs assigned to 个 he @ad 
variable in memory, new * html ,erb wrll be abk 
to use ft to generate the HTML form within 
the /ads/new web page. 




The method 

creates the new object 


Hie new.html.&rb template uses the 
object to generate the web page 
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inserting, updating, deleting 


Each page template how has a 
watching controller method 

llie ack controller nuw has one method for cak \i of ihc 
page template files. Rails will always call the controller 
method before genenuing a psi^e from die page template. 

It's die combination ul a com roller mcLliod and a pagt 
remplare tiiat make up an action- '1'hat^ why the aelion 
name appears in the name ol' the romroller method and in 

immt* of the piige Lenipla-Lc 11 HI 匕 


tr\ 


app 


An action is a controller metkod 
and a page template. 

一 ❿ 

]>i th 说 


麵 


controllers 



ads controller.rb 


命 


麵 


views 


class AdController_< ApplicationC 

def new 

@ad = 
end 



ontroller 



ads 


def show 

@ad = 
end 




> 



Ad-find(paramsfiid] 




def ifidex 




new.html.ert> 



Ad.f ind f ： all) 


Tb n 




^ ctr H 



show.html.erb 


ads controHenrb 



index.html.&rb 


Now you liave the com roller creating the new ad object 
before the new,html.erb page template runs ， k’s 
lime U> spe if the rode works. 
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mebay 




Tesr Drivq 


With the contrcsllci code m pkce, itV rime to try the applicAtiau 
again by opening a browser at' 

http : //localhosti3000/ads/new 
Now eiUtT ^oriit 1 daEa: 





The iorm page displays pri feril \； hut when you en(er soirsf dam and snbmii 
iht k Irsriru Rails n-iurns :in error tdlingymj chat vchi liavpn’l wriKen m rmiu 1 
at Lion, TJ it? creale aclion? 1'haL wus the aclioii vou dt^idecl wtmld reteiw 

JT 

Lt^c ad from the form. 

Wlml vviEl Lhis kit'Lion need U> do? It I) ml Uit - chaUi Irom llie fnrm ami use U 
Lu create a new ad 

But what does the form send back to the application? 
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inserting, updating, deleting 


The form doesn't send an object 
back it sends PAT A back 


\ \w \l snn was gmtTak*rt u.sini; : m r \d oh 卜 rL Bui vvluit docs 

ihe form send ly^ck to ihc server wht r n \hv Ini.m s sulnniued? 

B^cfiussf ihr form iim ^ H I \ '\{ it ran t senH ihe lorni ohjrrt "ver 

I I n 1 iielvvork* hislt-atl ii ,st b nds daLi, 

Put how is the data FORMATTEP? 

Iliink b;irk to In >w roining vwj'ks., \Vht ti a m ri'n R^ils 

stands the details of the reqtiest to the roiuing systm which ins^rEs 
values iiitu ；i data structuff called paraiH3 [■■■], uiih valuers lot 

[\ir : siliun uni I ： lli^ i'chiLi uIIlt. 


Thr pa ram3 [ - , . ] fLiki slniriurc 1 rmivd ； jusi fnr routinp：' 

11 ran also used t<i store 扣 ty submiUfd lu Ulf 社 m 

Ijy a wel) form. 



A U u ni's lit ajtf ivrorded in the ] table akin^ 

witls LhciiLimr : ad. I linK the v.ikit h til thr : ad is 

^il tiiislly ^not/u r tablo oi valoes, a E able that map^ ci Hold n^itne to a 
fidcl inh；( l : 




AiiuAlly the data i 3 

«IJed a HasK, * ^ 


is 4-k 

㉝ 抑 , 



Name 

Value 

icontroller 

1 ads 1 

: act ion 

1 create * 

: ad 

c 

?a r3^fter H 

t^Wc 

Name 

Value 

inairte 

Led. ther boot 

3 : description 

Suit person with left foot 

: price 
■ 

1 . 0 

:; seller id 

242 

: email 

betrt@hottii.-iil h com 

: img url 

http : / /www , j avaranch - com/ images /boot - gif 


adi is 

阶 amS Dad] UWe 


But what happens to this data when the 
controller receives it? And how can we 
actually USE this data? 
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from data 



Rails needs to convert the data into an 
objeet before it can be saved 


Rails i：i\n (m】y Uit s tls to Lcilk to till . 5 daiabiist% so brfori" an tul cn 
be iave<l to the daial>asc, \<m need to iliid ^ome way to D:>tiwrt tlie 

p jt ■ 

form data mlo an Ad object. 

The model can create objects from raw form data 



@ad 


How do you do rhat? Wdl ， remember when you rreated a new 
bl^nk /Vl nhjprt to usv with ihe frsrm? 


@ad = Ad, new 


Ad 




The Ad. new method can also he called with a oi hash table ul 
^ alue^ that will be used lo iniualizc ihf attribin^s of she n^v Acl object 
And ihr fnrni data jus I luipp^ns lo he rtmtuinf'rl in a hash objert ： 

@ad ; Ad,new (params [ : ad]) 


b the 

foTTtt di"bi- 


id 


lr 



dBacri P ti^I 



厂一 


d 

1 a«lUr id~1 

i 









Ad•new( 

—— " 


Value 


Leather tjo 口 t 

: description 

Suit person with left foot 

: price 

1.0 

: seller id 

242 

ieHiail 

bert@hotrnail. c om 

i inter ur]- 

p http : / / wwu . j ^varanch . cqtti/ images /bopi. # 

▲ gif 

- iP - 

t ne 也 ‘ W £ he / 

、一 =_ otjrtt mahh ihf 

‘ W 地 _ 
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inserting, updating, deleting 


The controller create method, 
step-by-step 



Rarls s^nds th& form data to th 毯 controller using 
the parains [. , * ] hash. 


para ms 



The create method 


def create 
■ ■ *paranu-;[ 


end 



The controller can read the raw form data by 
looking at params [: ad]. It can then send this value 
to Ad. new (. *.) to construct a new Ad object. 


pamms [: ad] 




-_■ = Ad * new(params [ : ad]) 

■ ■ n 

end 



The Ad object that is returned by Ad . n^w (.. *) has 
attributes that match the values rn the form fields. 



end 
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saving the record 


The controller needs to save the record 

Ihe whok reason I or rrmvming l\w form data inLn an ohjerl was sc i 
V<iU txiuld iL, 

p 

How clo you do that? With 
@^d.save 

When sa\e b called on the model object, Rails insperls rlie attribute 
Lind ^er.fTaieH a S (儿 histTl filaieinfint eo update llir datahasr: 



save 




£ ™ ih 4 - L T 11 * the 



Model 


T\>c 


retc^d l _s 



insert into ad5 
values f “ ■ } 


1 Id ： 

EJM- 

LMWCTJ^pbidb 

PITLQ» 

HllM ■ 一 id 

■HJ.1 

LM OMl 


_ „ = 


T i 时 

^i| 




-i j-" - ■- - - fc - 






▲ 

F&i-tMi ： 

S^M iEeEIilfl f.. 


ii 

Afl£ E 濾 ,v^ 


1 3 

Hi 

31:4^11* acrtii 酿 

； y+i j：i 

5C- 

Icjith^i Sirtaiil 

±it^p ■■ i ■‘loan ..... 

i 

□talk 

mik dMk _ 3K. 

iIDD 

1ZJ 

mlyfa Ht 11 .c _ 

Cfl ■ 丨 ■ pn CJI u u 

[| 

Ibci Carraizi 

5jfl*ZMd KC? EKI , 

n. 


diBfnj'Xjcr-sM b 1 :. 

r=cp=/,nwwr. S c. 

[i 

App:_ S«Kw=, 

JclEl Kxki 1 H 

Zi 


i>u re 圔 1 d 2i E! » E°4 

1 •:守 i 6 户 dW s ds.f 








[t 

9sj^=1hu Cl 

XHJCDl^r eiiR. X ■■由 

T12. Dfl 

HI 

=^j.m|aui=Xmix. 

^sp^//wu iba 


S b>1l JT^| E. HE. I£ . Ji IA . k J4L, ■■■m ■ ■ ■ T. ■ 丄 ■- B r jTTM 1 


With ths ： &£ivc in place, the controller's croatc metJiod h complete: 
def create 

@ad=Ad.new(params[radj) 

@ad-save 

end 
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inserting, updating, 3lt7Cl deleting 



Updaie your romrntler s i reali* rneihofl s anri Iry out 篇 lie i ipdtilecj arl 
LTruliuii Ibrm. When you rlirk C:rc^Ue, an t Tror pige k seiil batik 
fiHriphiiiiiiiig' al>uul h rcniplaic ： 



- ^Sharpen your pencil 



Was the record you created saved? 


3 + . + H » + . ■ 9 ， + I ■■ 画 ■ 4. + + e 9> + + ■ ■ 4 


2 + What do you need to do to fix this new error? 


i ■ 4 + I- hi 4- + r ■ a 


■P ， ■ & s|- -P ■ S S- * - 


P ，警 + 
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every request 


response 


parpen your pcil 

Solution 


1 f Was the record you created saved? 

The da 七 a was ^cd s<? the new ad was tvtated- 

■• + + e 1 + + + S 9 + + i B i^+ + i a a- + !• i I + •■ B ^ ^ i 4> -I- !• S i- + + ii fi i + - 4 a •!• + -8> i i + -«• + P i + + « R ■ •« ■ ■• + h 9 d- + + fa 9 » + 


2. What do you need to do to fix this new error? 

vas no tc^plstc a^ilabl; io c^he^r^te a response to 
toi^Vih -tkc retard was saved - so 3 dreate p^ac 

■• + + 9 ^ + + 4b«++BBi++iB-ri + l>fci++HiaiKriil> + ■«■> + + •«■ 9 + -«rfd- + +Bi#+i!bi++ii#!iia++ii#-r + fa i !#l+ + bJ + + 

hc^ds to \>t 


Raib was complaining because it bad m way of 
generating a RESPONSE to your request 

ITTTP works usingpairiS "f ivr|LiesLs cinct I'rspiin^'s. For every 

ii 1 quest, thm t-’s got ki hv a rc^puii.se. 

\\ hen lhe roiitrolkr^ rreate rtiPlhod r<implelpds ane'v rmirfl 
w 如 iTeiilfd slk ressfnlly. I hrn Rails nei a tltxl Ui ^riterak* u 
ropim vi* 1 Wi w L [ Iniiki'd tn] ilir pn:.M- R EiipkiU. Hicil [Ihiirlii、I 1 J 31 - 

cmrctu action. The clut( nt action was create so it looked Ibi 
create, html , erb. But i 1 ir( template dnran'i exist! 



So we need to write a createjitml.erb page 
template. But what should the template have in it? 
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inserting, updating, deleting 



E^RciSe 


Create a create _ &tmi. erb file to tell users that the record has been 
created and provide a link lo the new record. 



laers ikcy 
^CCeisLliy in 

a«d a \mk b> 4c 

ad. 



you are here ► 
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here's your 



You should have created a create Jit ml. h f iSe to confirm that the 

record's been created and to provide a lank to the new record. 



Vour rtTML ^ l«k a hU!, d 沿 ⑽ t 

杜 扣 thi T^at s okay as 

3 iVe 



<hJ>^d crtaitdU/U 


> 


?^h U He hewly 

■ 扣 erttd object 


M't、 your ad hv^c-f~Vads/<%^ i^ad >d 

V — — j 

^_ wsf' 




This ts family smf\ Cf hrcA^c ^ m 
^fcr-U^h^ ^ provides most oi 

the ^kuv 

ij I 


、 Pa 认 b 

㈣ atsd 总 d ， 
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inserting, updating, ；3 deteting 




Tqst Drii/q 


Now rhat ymi h^vp I hr create* n+.m 1 *erb page tcmphire 
in place ， it’s lime lo irv nut Lhe application. 


NffW 4ll 


AJ 


mw\ 


Ad crcaEedt 


f^ Y 灿七 hii 
you ^£七 _■• 





一 5 

3^^cr^icd by 



i^t ^ a<， ' 



Soon the users have posted 
dozens of new ads. But even 
though Wb really popular ， 
some people tiave one small 
complaint.., 



o 



Why does it show me o confirmation 
page with a fink to my new ad? Why 
not go straight to th£ ad? 



_ 

Is there a problem showing a link to 
the new ad in the create page? 

If so, what is it? 
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reuse 


PoM't create a new page, use an existing om 

Hie users don't vvaiis to see E.lif 3 int^n^nin^ r(inJirm;Uson 
pag^ generated by crea te . h Lml - erb, Hlify jusl vviiri[ 
to gj alrai^ht lo iheii ad, Su vvhiit do you do? 

Yt)U i-onId edii llie create . h tm J .erh page lemptaie so 
lliiit it displays <tll of ihv iww 1 ad r s diHails, rigli 【广 Alter all ? 
the gad varial^lc k visible Itoiii tJie page template and it 
coniaiiis all ol the detiiils of the m \y ad. 

But that would be a bad idea. Why? Because that would 
mean that the create . html, erb page would be 
exactly the same m the show, html, erb page template 
ynu Use t«> display each ad 




Model 


Controller 



u 





dli P^aic 



c reate, htmLerb 








That 、 duplication, and il wouk! mean y”u had more 
rodr" te? mriintain in ihe fiikm It would he niudi belier 
if i\w c re£3 Le iit'tksn iu iht 1 rontroller van clioost 1 lo 
display the show ^ htnil - ^rb payt\ 

l^vri ah ad 


show.html.erb 





^ ad i s ihfiw r J , 

^ r ⑽ 


Model 


Controller 





pisplay 3 ^n 3 fd 



^tiow.htmS.erb 
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inserting, updating, deleting 


Put how can a controller action display 
ANOTHER action^ page? 


A controller method works logeiher vvilh n ienipltile iu lorm 
hii In all <ij llu? examples you.vtr seen w.} ran tnilh the 

coj itiulk r mt-'Lliod and Ltic page IcmpkiLe have l>eeii eXLluyi\x:ly 
used for one action, 

ThatV why iht: contn>ller methods iind iht: page Lein plains have 
included the action name somcliow. When you were per lorm ing 
a show action, you usefl the show mclhocl in l he ad hi trailer 
and the show .htmi .erb page template. 

And we still want to use a coniroller melJirjd aticl a page 
lemplalc to conipkte the action, but ik»w we want to be ahk lo 
choose ^'hich page template gets called witli tlw controli^r 


A controller action is 
a controller metlioil 
and a page template. 








http J/mebay.com/ads/10 


We need a way for the controller to say that the 
output is found at a different URL. 
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redirect ■ ； nnotho art 


Redirects let the controller specify 
which view h displayed 

A redirect h a special kind of response liom the Rails 
application to the hrowwr, A redirect TeUs the browser \o go to 
a U l\ L fnr out put * So ewn I hough thf t ， m\vscT sen i ihe 

lorni daLi l£) /adr>/c:refit-G, a iTdimt sends iht* hm\wir U> 
ads /17 [lot example, if 17 is llit* id iiunib^r of the new ad：. 




-r^ lS is a f 


http: //me bay. c o m/ad s/cre ate 


W outfit 


an4 
Rt ° 


rw 


swv 汁 ^iurns 

l^ eaiiKe 

afterh^tc U^l 飞 


http://mebay T com/ads/17 


showhtml,erb 



ChsptB! 
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inserting, updating, deleting 



&l>arpen your pencil 


The redirect command wi\\ forward the browser to the URL 
of the new ad. Fill m the URL: 




Pa 


crea 


1 ■ new {par.[ : ad 


Pad,save 


redirect to 


/# I 


end 


tlrereiare no ^ 

Dumb OueHtJPns 


You said that a r&dir&ct ts a special 
type of r&sponse, ts it realty a response? 

Yes There are several types of 
responses. Ordinarily, a response contains 
informaSionfor the browser to display, but 
other responses—like redirects-n：ontain 
special srstructions for the browser. A 
redirect is a special instruction that tells a 
browser 1o go to a different URL. 

cv 

Sc if s browser is redirected, does 
the URL in addre$$ bar change? 

You got it. Even though the browser 
made a request for a particular URL, the 
address bar m\l update to show the URL the 
browser ended up al. 

Oj if I make a mbtake In my code, 
could I redirect the browser tn some sort 
of infinite loop of redirects? 

No, because browsers have \m\is 
about Ihe number of redirects they will follow. 
If your oode sent continuai redirects, the 
bmw$er woiiJd get bored. $top following the 
recti reefs, and display an error message. 


^-r V' ff 1 set 


@ ad to an obj&ct and thsn 
redirect to a different URL, will the new 
URL see my @ad object? 


Good question! No. it won't. Once 
you ve redirected to another address, none 
of the variables assigned by your controller 
will be visible at that new address. 


(d Can I redtrect to an address outside 
my application? 

Sure. A redirect is simply a command 
to the browser to go to a specified URL, If 
you want to redirect to an external website, 
go for it. 

When would ! want to do a 
redirect? 

/\l You might do a redirect in order b 
re-use a page that displays information^ 
That's why you're redirecting in the MeBay 
application But it's also a good idea b 
redirect after you've made an amendment to 
the database 


(七 


Wh/sthat? 


Jt's a good idaa to split actions into 
two categories: update actions and di$piay 
aciions. An update action will diange what's 
on the database and then redirect te a 
display action That way, if someone enters a 
record, then clicks refresh on the next page, 
they will only be refreshing a display page, 
and not reinserting the record. 


/ What do #{ } mean in the 
redirect string? 

/\: Riiby slrFngs can in dude Ruby 
expressions—like Ruby names. By placing 
them between # { } you’re telling Ruby to 
replace the expression v^ith its value. 

()_ 

^ / pa rams [. * . ] looks a little like 
an array, h ft? 

params 13 designed to work likg aa 
"associative array 11 —otherwise known as 
a H hash' A hash is a special type of array 
that can be indeed by things other than 
numbers, 


you are h&r& ► 
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create, read. 


parpen your pencil 
k Solution 


The redirect command will forward the browser to the URL 
of the new ad + Till in the URL: 


def create 

@ad = Ad, new { pa rams [ f ： ad 3} 
异 ad-save 



, aUe J a MariAU a 如崎 


end 




resT Drivs 


(jO alieatl and updaLu y<Jitr coniiollen Now ifs 
iimr Lo sn if uLir r^dii^ci ^ends List i s to thuir ncwh 

p 

created acb: 



When a new ad is created the browser 
automatically jumps to the new page. 
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inserting, updating, deleting 


Put what if an ad needs to be amended 
after if s been posted? 

Hoim^ ii^ei's Irnve made mktakeg in their ad creations, and want jnake 
changes lo ihnr ads. So Hiey want more Umn jusl display iaiid ciTalion 
forms. Users now want to be able to edit iheir ads. 




Ads: show 



This means the system need to allow updates as 
weti as inserts. Will that be difficult to do? 


you are here ► 
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updating 


Updating an ad is just like 
creating one … only different 


Eveji though the s)^tem emit currentiy edit ads ， v\ r ilI it be a 
work to add an editing; feature? 

lliink fora momeiu about the sequence tlic system goes through 
to insert an ad into the system: 


O 

0 

O 


A new blank ad <jbjcci gets created and this is used \o 
generate die ad input lorm. 

The ff>rm is sml to the wer, who updates iht* iif'ld 
Viducs and 讥 iljmits llie IbiTii Jjack to ihv applkation 

I lie data Jirlds mv tmcrlnrl Ii;wk into an Ad 
wliit h k saved In thr dataljasr. 



\ he Lisrr is lorwardtfct Lo a page displaying ili^ new atL 



1* Create 
blank ad 


2. Fill in 
the values 



3. Save the ad 


4. Display 


Suppose you want ro change a pa^e What wcpukl you rxpeci to ^ee? 
Maybe a lorm with the fid dt fc [；iib thnE vi>u ri-m muhmit and have the 

t liauges siiveti, whit'h is kind nf eIh k saint 1 se(|uenct j Vf>Li used lo 
adsL Let、look at iht ： thsirigc sequence in more detail … 
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inserting, updating, deleting 


Instead of creating m al you need 
to find one;Instead of saving it 
you need to update the ad 

\Mu n ^omcoi^e edits ad. thcy'IJ use a form ju&t like lx lore. I he 
us€r will change the details and the acl data will be savccL So just 
how similar is the change sequence to the creation sequence? 


❶ 

O 

O 


An existing axi read fn ni] lilt- ihitkibast^ anti lliis ad 
will be used to gmtfatc the change form. 

The form is sen l to the user, who updates the Geld 
vakit j ^ ；md submits Lbe lorm bark “】 llie ^ippEiration. 

The data lie Ids are converted b^rk into an Ad object, 
whirh h Lisrd to update t\w dataKase, 



❹ I h^ user is forwarded tt> a p:i^e displaying ihe 

updated ad. 


deacripti 


pfiice 


@ 


ad 




ifSTiBl 1 


tsm 




1. Road the 
ad 


2 + Change the 


3, Update 
the ad 


You t；an see that the sequei^ce lie twee si the two operations batxly 
differs at all ， In Hie creation sequesice, a new ad oE^ect h created 

Luid lo Ult 丄 claE ； i1s;t^t\ In thf" change sequenrf* an existing 

ad is read' updated, aiid saved t(j the dalabiiiie. 

So von neecl u_ make ^mx you take the dillinencc s hr I wren the t\m 
n])eraliniiH into accTiimi. Vmi'il nred lo keep Erac'k o| things like \Uv 
ad id mini her in tJie elicinge stquunCL^ 

Do you think you could add an edit feature to 
the application as if stands? 



4, Display 
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change 



jtPrtf ExeRclSe - 


Add an edtt link on each shew page to a URL (like ads/17/edit) that calls a new edit 
action to look up the ad and display it in a form. 


Imk Were 



ifjrktc 


Jlrjhc v** 0 










The form will submit its data to an action called update at a URL like /ads/i7/update. Create the 
routes that would connect /ads/17/edit to the edit page and / ads/17/update to the update 
action, making sure the ad Ed number is stored a re qtest parameter called : id in each case. 


+ + l<ld> + +Ea++r 


# + + !• a B + + + 1 i + + I* 
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inserting, updating, deleting 


Now create a new page template, edit. htmi _ erb, to allow the user to edit the ad details 
Ws similar to new, ntml. erb except tt displays the acfs name in the page heading and it 
will use the 'update' action instead of Ihe create 1 action. 


地 Iw 




Vitvc v 


You II need two action methods In the ad controller to provide data to the editing form and also 
to update the ad in the database. The edit method will provide data to the edit form, and the 
update method will update the database. Given that ㈨ 丄 

@ad. update^attributes ( ... .）^ :』 dd 


-will update the @ad object on the database, write the code for tie edit and update 
methods of the ad controller below: 


l/i/rite 如 
hcv«. 
















the times, 



ExeRclSe 




Your job was to add an edit link on each show page to a URL (like ads/i 7/edit} that 
calls a new edit action to took up the ad and display it in a form 



The form submits its data to an action called update at a URL like /ads /1 7/update. So you 
should have created the routes that woutd connect /c-ids/l 7/edi t_ to the edit page and /ads/1 7 / 
upda te to the update action, making sure the ad id number is stored in a request parameter called 
: id in each case: 

mipXohhfidt / Ads/ 'id/edi"b\ : ton^ol ]> l Ads t /Wake sui^e yeg ifeary I 

^ 叱 Irou^j 來 

»3^£orineC't Vdds/ '\ 6 / updi^be^ : fioivtro!W=>'ad5 , , : attiw 二 Ajpda'te 1 「户此 


■fe i a i + + 
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inserting, updating, deleting 


Your job was to create a new page template edit, html* erb to allow the user to edit 
the ad details. It's similar to new,html,erb except it displays the ad's name in the page 
heading and it will use the Update' action instead of the 'create' action: 


<%— ⑨ ad‘wc %x/Kl> 

<^><b>K dmt</b><hr /><% 二 %></ p> 

<b>Dcs^ri pn</b>< b^r /><%— dcsiHp-tiqn %></p> 

<b>FVi cc</b><br /><:%— f-tc 乂七 —field -yntf %></^> 

<Y> <b>£c 11 fv</bxbr /x% 二 Ltexi 一 f eld sdlc^jd %></^> 

<Y> <b>£ma i! </t><br /x%^ f.twt 二 field : e*»ai| %></^> 

ii^t</b><br /><%二 f %></ f> 

( 叫 bmil ' %></ 

<% cr\d %> 

You need two action methods in the ad controller to provide data to the editing form and also 
to update thi ad on the database The edit method provides data to the edit form, and the 
update method updates the database, So given that: 

0ad.update attributes ( v^ra^C ^dl ) 

■ BS+-PP"+RB 4 - + -FB"#HI- + + -PIP-Pi 


I J” rr^Q t 


—updates the @ad object on the database, you wrote the code for the edit and update 
methods of the ad controller: 


def edrt 

3ad — Ad -f trvdfpara^s^idJJ 

tnd 

•k ■ i ri + 4 ■ ■ ri a + ! fa ■ I i ef 1 Hh ■ ri h ■■ ■ ^ !+ ■fa k i + 4s fa ri ri a + h i ■ if 1 -Is ■>■ H d ^ + h , d ^ # -fa ■ fl ri + ife 

-FiB4- + +is+ + ^aiii-+pia++Ba!i° + +ee+ + +e4+ + «ia+ + +ie-a-v-ppR4%°iipa-"->i--PB""->|i 


dt^ update 

&dd ^ Ad ^d(yara msC idJ) 

Ssd upd^t Htribu 七 esfP 狀 
incdiflrcit io Vads/^l^ad id} 1 

Crid 
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test 




resr Drivq 


J he edit *htxn 丄 *erb page templaie is in place, as well 郎 the 
routes and the additianal methods in the ad controller. So nowit^s 
time m test I lie au fc w rdihn^ leatuie: 




⑽在 SST 



Editing Leafier boot 





■- - 




0ntc a seUcr s m tWc ed^t 
ti>CY tan awend 

detiils ^ a dp 

hit the “Wfdate" 




The code’s in place and the editing feat life warks. 
So we "re done-iM right? 


\ , 

Tlhc seller s ad 

ii 叶 dattd ahd 
db^la^ed 


140 































inserting, updating, deleting 



Wd 肀 [No fair. When we started to create 肀 his 
app r you $<iid we eouJdrV 肀 i^e $caffo!dmg because it 
allowed people to do too much. Now that's exactly 
what people can do! How do we know that people will 
only edit their own ads? What's to stop someone 
from messing with somebody efse's ad? 


What could be done to the 
editing feature so that ads can 
be changed, but not vandalized? 
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securny 


Resisting access to a function 

Thr appii< ?iii-rm rnn tiow mid ifpdnte data, Bui \h w 
iiidns wlm c；m i iTfUe ati ad can U|xl.ii< j nil nd^ + And 

a pi'obifiiL 

The MeBay owners want anvone to he able to create ads a but 
iUv\ don't uant evervbodv else if i ht -ihU* u « the acl om ： t fc 

ira been puis it: d. 



厂—洫 cr 




*r 



Controller 

update 

method 


One w^iy of prevniLiiig jLisl iiuyoju , c hiy i^ti^ ads is io pnitect Lhe 
update flmctk_n with a usernanie and password. 

The gins iil Me Bay have decided lJulI oniv ^ysUw 厂細 

will abJi fr Ui dian^ nd^. So tlicy want ilu 1 nvw Lipckilr 

fuiK rinnaluy srcured with im ;u1min ;ind pas&wurd. 

¥t fi iLiiKilrh, Rails nmtaw ii really t^iHV Ln tlrop s^rurilv rin]i[ i,u. 

\\(: ， re- l<> List' a tip-ecitil kind ol wd> sucuHty iulkd HTTP 
Authentication. 1 his h tlic Idml "f ^ecuriLy that j>oj>s nj> a 
Hialug box and asks Jbr a usermm^ and fmssiv^rd when somTOne 
irirs 10 _TittT secure “ w^h «ik\ 
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inserting, updating, deleting 



Reaps B3K6 

S%H*Xll Ow 


lb add Jo gin st'c itrity to the [ipplication, you need to add two pieces 
oY a »de lo the ad comn>Iler: a login method lhat e luct^ a username 
and password, and a filter that calk the login method whenever 
certain melhcxls in ihf 1 controllfT arp a< cesseri: 


TKis 




This h ihc 


class AdControl 丄 er < Applicat ionContro1ler 

before filter : check logged in, : only => [ : edit, : update] 




def new 

@ad = Ad.new 
end 

def create 

@ad = Ad.new(params[:ad]) 

@ad.save 

redireet to w /ads/#{@ad,id} tp 
end 

def edit 

@ad - Ad., find fparams [: id I ) 
end 

def update 

@ad = Ad.find(params[ : Id]) 

@ad ， update_attributes ! pa rams [: ad] ) 
redirect ^to ,f /ads / # {dad „ id] fl 
end 

def show 

@ad = hd* find (pa rams I : id] 

Bud 

def index 

@ads = Ad.find( : ail) 
end 




You ^i\W oJy ask 严。 fie ， lojp ^ 
bry 3 £ 4 .esi -t"hc cd^t or 

’updsW methods- 


or # 


wl, 7i ^ 

，i£ - ^ 
V 


private 

def check_logged_in ^ —- ^ 

authenticate or request with http basic ("Ads" 1 } do | username^ 
username ~ 11 admin ，T && password ,p t4k3th3r3dpill M 
end _ 7^ 

end ^ 


password! 




The pass^c^ro 


end 
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stop the 




rQST DRIV 8 


Now that thr security rode is in place, U 、 time lo open tip your 
browser ami trv tf) edit an ad. 



tUt Se 

r 




yw 胃 癲 :，::: 一 ‘ I 」 

— ^ — - I 

hiH^LJW' W ，J I 

-^■IFilMiVilL ，》 — aa^ia** | 

_ I r=n ■ 

tiLv aftrt _ 

- a I 



Now only people who know the admin username and p 如 word 
ran edit ^ds on the silt' Nobndy else ran get al tlw edit paj>e or thf 
update fimclion^ 

In it important to secure both the page and the update Function? 
The edilpagp should be ofT limits to prewnl people accid^ntally 
acce^mfr il Lind vvasdiijj iheiv time enu ： rin^ datiL Not only iliau luu 
the update rune dan (the code that docs tilt actual tiataba^t LijjtlLite) 
also needs to lx" secuic ill case a hacker irici? to access it dLccllv 
without using the edit form. 


0^ users ^ 

Jrcti 1 一 


YouVe manualfy built a system that can create, 
readf and update ads... 霣 ml『s secure! 
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inserting, updating, deleting 


... but how old ads need to be deleted 

r llw sitt up iIikI rutviiin^ :md rwryll line's jroiny i^nraL, \yu\ id [it lint 
too long there's a problem: even after stuff gets Isold ， tile ads stiiy there. 





Dude, I already sold both copies of my 
Lawn AAawer Marf DVDs r so why am I still 
getting requests for it? Is there no way to 
take my ad down? 




McHii% t'ouhf usr thdi'mvii data mrv svsti/ms k] rcmn\-e 

■ a ■ 

ads lixm thf she, bill they wrc so impmsccl by haw 
simple ihe change Itint tion ih^ VI like ynil to add a 
del^Ei 8 rimrlhm \Uv wrljsiLc. 

The feature will only be available to MeBav adniin bimtnrs. 
： 5f^ they W[-inL Hie s^nif 3 simriiy tli:il was E i]>] ilii. L d in the 
rhiiiige HiDclioruiJitu Also, [M'Oaust 1 Ehefe^s bf^n ;i Umi of 
s|jttm aii well lls s^jine ^puul' cicis pMk.d unto the siu', tliuy’c] 
HJa t" tnakr ihv tlrlctr [imciion (/asilv ■itvailahlr Ihnn llir 

m 

ind^x page. That wjiy ihcy can miiuve imippropi iatc 
⑺ ntent v\ i(h a sisi^Ie dk k. 


Let H s look at what we need to do.„ 
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create, react updBtB, and dBfete 



jtPrtff ExeRclSe 


Update index* ht.ml * erb to add a delete link next to each ad. Ifthe ad has id : I7 h 
then link to /ads/17/delete. 

h,l>All Ads</hl> 

<ul> 

<% for ad in @ads %> 

<li ><a href= T Vads/*" %= ad* id %> ,T ><%= ad ，- name % >< /a > 


<a href 


>Delete^/a>] </li> 


% end 
/ ul > 


w 


Create a route that WiFi connect paths like /ads/17/delete to an action called destroy 
in the ad controller Remember to record the id number as a request parameter. 
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inserting, updating, deleting 


Complete the ad controller code to delete an ad and send the iser s browser back to the index 
listing all the remaining ads. 

To do this you will need to use a method we have not seen yet—the "destroy" method. This will 
delete an ad object from the database. 

class AdContrailer < AppIicationCcntrollsr 

before—f ilter : check_logged_iii^ ; only => [ : edit, :update^ ] 

def new 

@ad = Ad,new 
end 

def create 

@ad = Ad*new(params[ : adl) 
save 

redirectto M /ads/#<@ad,id} M 
end 

def edit 

@ad = Ad* find (parains [ : id]) 
end 

def update 

@ad = Ad,find(params I ^id]) 

_up ■ 二 iate_ attr ibutes (params [ : ad] } 
redirect_to h! / ads/ ff {@acL id } 11 
end 

def show 

3ad = Ad, f incHparaifis [: id)) 
end 

def index 

@ads = Ad,find (: allJ 
end 



㈣ itm 


private 


def checlc_logged_in 

aut1ier]ticate_Qr_ re-quest_w11h_http_basic ("Ads h, ) do | username^ password 
username = IT admin 1f && passvrord == ,T t4k3th3r3dpill T, 
end 
end 


end 
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this is the 



tPn% E^RciSe 
tSotutiort 


c Toym the 

^ ^cc^rdcd ty ^ 

敬 i 抓 tailed W_ 


/ad ad ： ld %^/d^Lctc 


+ 


You also should have cr&ated a route that connects paths Nke /ad^/i 7 / deI Rte to an 
action called destrov in the ad controller. Record the id number as a request oaramete 




io 




^ p^i ^ 

c ^ikd : id 




inserting, updating, deleting 


Your job here was to complete the ad controller code lo delete an ad and send the user's 
browser back to the index listing all the remaining ads; 


las.s JkiContrallei < ApplIcationContioiler 
before filter ^check logged in f ：only => 


edit, : update f “… J: ■ K S B ■■■■■■ Mi I 


def new 
@ad = 
end 


Ad * new 



def create 

0ad = Ad, new (params[ : adt ) 
Pad-save 

redirect_to 11 /ads/# {@_ad* id} 
end 


Wj|/ 

^ io 3 i Vtf 5 

f 


def edit 
@ad = 
erid 


Ad.find(params I:id]) 


def update 

@ad = Ad * find(paramsI:id]) 

@ad .updat e_a11 ritautes(params[ 
reditect_to f @ad. id I M 

end 

def show 

@ad = Ad.find(paramsf:id]) 
end 

def index 

@ads = Ad, find t : all) 

end 一 *^*^^*^*^ 

def destroy 名 〆 

Sad — ^d 4-i r\d(yBram%i u \d2) 

+ B B i + !• e I + -fa ■ ri rf- + -fa 4 + + F B 4 4- + I 1 + + B B i + + i ri' + ■ d fa 1 i< 4- + a 1 + F H B> 

+ destroy 

rcdiireit__to Vads/ J 

I _ ■ 圓 _ ， I .峄 ， g qp .警 _■ n n _■■， 琴 釀 ■ 申寺邏囑甲___»___» 

Chd 

private 


ddj } 




*'thci% Y 014 

vedkett 七 he Wowser 
back tc the ir\d^ 


def check_logged_in 

cLuthenticate_or_request_with_ht ： tj^basic {"Ads") do I Lisername, 

username — ^admin^ && password -- <t t4k3th3r3dpill t|i 
end 
end 


password 


end 


you are here 
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one more 




Tqst Drivo 


The cksLrfjy iictitm mL\m^ liters can delete ach from the site wish a single 
click. It uses tht k same security as the amend feature, iso before anyone 
can HpEetf an ad，lliey mmt liir^r provr that iht"y ? rc an administratrm 







MUQMaJUaOflli 


Now that the fivstem can ddete ac!s, vom 

/ ^ tr 

applkation can peilbrm all of the ba^ic 
CRUD opera (.to n^: 


Feature^ 

adG (display the-i) 


But then f so could scaffolding— 
so why write your own code? 
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inserting, updating, deleting 


Poing if yoyrsdf gave you the power 
to do more thaii scaffolding 

You can choose what tuncdon^ an- iwaUable. 

Ybn can add additional fcaturci like security 

t 

And now you understand how lo malt* (: ndt* 11 ml inHt*rls ; 
updates and deletes youlJ be abkr 10 amend iht f code thk\l 
scafFoldLig generates. 
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rails 



Tools for your Rails Toolbox 


You’ve got Chapter 3 under your 
belt, and now youVe added the 
ability t 。manually create applications 
that can insert, update and delete data. 


Rails Tools 

孩 ad save saves a model 

铷 dU?daUV'buiw a -odd 却 tt 

IHs to^broWty tKe 

Viv-owsev- \fi 3 di-f^re«4 URL 

»akes add'n^ 冰奶七 y a 

trcc« 1 

Ruby Tools 

parad u a *KaiK^ is Jik ,： art 
anra y ^dt^ed by 

* I * dl:? _ de ^ li 

/wirfc calhrvj mcthqdi oft S h ij 易 ㈣ 七 

C3use 其 errors J 
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4 database linclers 


Truth or consequences? 


♦ 


I told you that old 
woman wouldn't give up 
her marble loaf... 


Every decision you make has consequences- 

In Rails, knowing how to make good decisions can save you both time and effort 
In this chapter, we ll look at how user requirements affect the choices you make, 
right from the very beginning of your app. Should you use scaffolding and modify 
the generated code? Should you create things from scratch? Either way, when it 
comes time to customize your app further, you need to learn about finders; getting 
at your data m a way that makes sense to you and serves your us^rs 1 needs 
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user 


it. 



Keep fit with the Rubyville Health Club 


I lir kuby\ i|]p H^ahli t H pridt-h liself im its al \n Hiif! th^ prrfpri 
t lor rvtnA'rJii^H and 「 ".(tieIv iht a v\IciLnirlu^l a iicu jm"nat InvineT 
: stTYid. Demand ibr ihv service i.H Isiyli … su iiiyh llir traiim are 
having troiilUe keeping ti^uk of all iheir clients, llie trainers need you to 
build an applirautm ibr tlu/ 111 . ami 


Business fs really taking off, but 
we're having trouble keeping track of 
all the personal fitness sessions of oar 
clrentSi Think you can help? 


I hi' JjsiiiitTs nvrd is w( s h *u iniatih^ Lhcm lu 

tjLik kJy jud ciisily manage ihv u p ui bcruts ii»r cadi of then riifitnmrrs,. 

To start with, they need somciliiiiLj 11“ii lists basic workout details ibr 

d O 

each client and allows them to add, njidate and delete records. Here、a 
skeich nf ilie main p r Age ： 


。。 O fl-pj 





Listmj firien't workout for LeviviY ^oldber^ 


TniR0 Dkrtiw 

cut 

9rid lO 

S 吻 5© 

iVUr^n 

Ct-ri 

k> 


Dair *f wmkmt P 加 

Oli^OO MTC V>X) 

oi43^o utc wc 

100^-09^1 MTC 75.0 

iDOi^Ol^ll m^OD UTC 1^0 
zoo^to^ol oWM UTC VijO 

\\mm utc Vi^o 


diciti ms^»t 


Siw £^rt P«i(r«y 
6dft 
SKpw Hii 
SKm P^tr^f 

£h«p Dtilwy 


LcftftV 15 

dierit wsing lpe^rio^l 




: nhV 


^rKCM 
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finders 



Let s start the application by scaffolding a set of pages for this model: 

client-workouts 


Column 

Type 

client name 

strinq 

trainer 

string 

durationmins 

integer 

date of workout 

date 

paid amount 

decimal 


What should the scaffold command be? Write your answer below. Go 
ahead and run this command too: 





hen 


Now, look again at what the trainers want to do with the application, and write down any 
differences between what the application needs to do and what the application actually does 
based on the scaffolded version you just created: 


















>p 









you are here ^ 
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to scaffold : 



邮 d 铴⑽ ate 
a 撕恤 ato 
be We rvrmiM ^ |S 





^A tWti ~ 7 ^T 
\^Lt dW^^ c 
a^be” 扑办 — ， 


Let's start the application by scaffolding a set of pages fer this model: 


client_worKouts 


Column 

l^ype 

client name 

string 

^rainen 

string 

duration mins 

integer 

date of workout 

date ： 

paid amount 

decimal 


What should the scaffold command be? Write your answer below. 
n«by script/Mne^r3rbf sia+TOld t\ ieft-t_workou£ dliCTvt—nJrac^ 七 ting 

屮 + B d si i ■ J + 4 + d tl + 4 看 4 + h I d + + l! ■ » + fc h 麵务 + l! P ， + -B ■ « •警 + « ■ » 屮 + R B » + f •■ 晋警，咿 ■ ，寺 f S ■警 + P d + + ■ d »• + 噹 i ■ 4 + + ■ 4 fa a + I- I; H il + 4 k ■ i + I; fa 1 ri 4^i 

dunticm—mini!integer d^Vj^koutdSftc Y 5idemount-deti 


Your job was to figure out the differences between what the application needs to do end what 
the scaffolded application actually does 


The frai^rs want 七 o look at the ■wo^rkoiii sessions 七 hat ha 时 be(ft rttcfrdtd -fertr tlicn 七 . 



Th^ s^-P^olded appli^^tioiri wilt ohlv show vjcfrkon'ts a si^le di 作七改 ati the 亡 hcivts 

， Pfl<l+>iiP9*l++iS4+HR4-+«_l+4<ll^ + L >BS>+i>l>.»+l>FI，+ +l>l++FR ， l PP_q¥l- s l++PS|4++BS>l+ ， i>i++>fll9 vk f> ■ >!4<+B >1。 + 4 !•■.+ 戀 P fr + h !•■•«• + •«• b 罾 ■» + + F « + + i ■ » # P 

bo^eiht^ 

•iiriH + faBri++taBd + afa>i++aB«i-litairi'+litai^lii 


■r i- ■ ■ ri ■§ 


The scaffolding isn't right — birt do we write our 
ow« code or fix the scaffolding? 

T he scattblded application doesn 1 ! do exact ly wliat wt? need. Wve seen 
belf>re ihm it’s easier to rr^atf simple ajTplicalions niaiiiially^ vvdthotit 
lining ^'aflijldinK at ciH. Bill anotlirr Lq>]>ruarli is tej creaLe a sc+tflbldfd 
itpp, and du'ii fhhrr clmnge <■■】■ add to till' L'odi' R:ith ^tMicRikrs, 

So \\i\Ai shf>i3lri \\v fk> hm 1 



If you haven't aiready 9 use scaffolding to create the 
training app. Then we can eompare that to what the 
trainers want, and see how close we are^ 
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finders 


The application actually looks pretty close.. 


The re is one part <>i \\w rodr i\ml [m>kH OW similar io she 

page ih.n [lit j trainers wimU Tlit_ IndeK lists a sel (jf Lli^iL is 
the saiitr as u hill tlic Iminm hMc askid Ibr: 


infers 

ItZIU 


GIDEtDE] 


ttf :/ /lot d I baS^^OOO/t 11 Cht^wrlcputi/find / 



r w 


wWji't 


Lis^in^ filien^t wolrkovrts -fo¥- Leviny ^oldbev-^ 


Trainer _b«E P«tt 


cut 切 

Brad 

Swpi i'O 

CU 30 

S«r| 


IDCfi^Ol^ 

iooUl 

IDO^-OQ^ 

iDo^^la^ 

2X)0^ 


tlien t^jwo rko^t 




tw 


is 明 de* 

W %td^^ 


a?? 


liUrt 


Cite riW orkouts Index 


C 


+ 0 htt|>://focaJhoit 3000/dlcntvvorkoatS 


Listing client—workouts 

a tent nam© Tram#r Duration mins Date of wortcout Paid amount 

Kirk Stigwood Clint 
Ipnny Gnldimrg Clint 
iertny Goldberg 
L 鈐 firry t-inadtwirg Hw^n 


Lenny Goldberg Oint 

Lenny Goidbcrg Sar^ 

New client workout 


50 

2009-10*05 

50,0 

Show Edit C 

m 

700^-07-14 

?R.n 

- Shnw Friit n 

30 

2009-07-19 

25-0 

Show Edit C 



/h.n 

Shnw tmt U 

15 

2009-09 29 

1S.0 

Show Edit C 

JO 

2DDy-10-UI 

ih.a 

tdit _c 

30 

2009 10-OS 

25,0 

Show £dit C 


Not only does the generated page look similar to ivhai we 
iieed, uc know that a sciifFoldccI application will givcmUl 
of die usual ope rations on iho die nr woi'kont dm In other 
words, a scallbided appliration will, by ddauti, allow \o 
crealf*, irad, uj^rtaie iinr! delete rmr 叔 

So, in this case, is ii 1>eUer tn fix the scaffold and rmke 
I he rlianges we n('pd, ar start from scratch, like we did 
for 

■ 












































crud is pretty VBtuBhte 


WeYe going to fix the scaffolding 


W hen \ve cTt^iled ilie MHiay applu alion, wf* dcciicleH iinl “）use 
srall(>|dinj>; The reason for [his vva^ ! liat llie cti^iUH cjri^iiicilly wanlecJ 
suiiietliiiig so simple (Jmt it \\ hs r'a^ier to citrate the itp】)lkaikjii Froiii 
seratch/lliey wanted a lut less Hinctinnality than ^caflblding pi e ^ ides. 

This linif ciiouiid, vvr nvvd to dN i>f the C.lRL D operaplus 

\vc need to tine! the workout scsskms tbr an individual client. As wc 


need mi>re timc tionality. vve caji do most of the work uskig scailblding as 
the basis of the application, and then we can add to the generated code. 


^v C s us i|j 

Arte 


This is tHc fQ^ ^ Raik- 
a few 

说 ’ve a \\ this 

ioti alitf —p 



So hnw L^m ul. Hud a I id display lliv \v r orkout usicnii For ail 
iiKli\ khtal dimt? 






v^rc r^tiA \p do ^ add 广 

irth ^atur e J atn ^ 如鷗 

dost dont 
























daxabas finders 


Resign the search function 


I krrcsvliat [\w seardi ruiicLiun sJiould \ook likt. 


f 1J 

111 | [ ( j! I /fc j | j !■+■* r ■福 ? BTi-fci hr3 



1 II . _ —1 

—J- - 

Rwt o(( t need — 

為 喊 w Term wrtK d 

scaviK buttoh 

f 



卜 、 We need todt in 
ihc doptrolle'r {p do 
atlual scirtlhih^ 


t'iiwi 


p^ge ^ill look ki^d &I- 
l_ktf (he * 

f J 5 E wr ^h a srt Jinks to 
eAtk of -the remits. 



Yk weed a pajc l_st 叫 

tKtf searth iruuH 


So here's what you need to build; 



& 二=:\ 3 二广 


o 

❹ 

o 


F^e 一 ^ 


A new search page where the trainer will enter the 
name of ihe client. 

A find anion on ih< 1 cnnirnller that wilt do (he pclnal 
■seart:liin& 

A new resuhs page with a lisi of links id each of the [lient’s 

wurk^uLs — liiis u ill wtjrk kind oi like liie incJ 匕 K pix^v already 
generated by ihc scaffold bi g- 


■HI P 1 Iba 


So where should we start? 


voc/ 
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form 


iefs start by building the form 

Wt* have a few new rnrup^nfills tn rn A iile s sei sLirt with 
llu u UHer ink'i liK e. ThaL um we ll hv ahk a Lo m i l some earK 1 
feedback from the trainers. Here's what the search form 
trainers will use to find clients should look like: 



\bu'¥e iHiUt pages wkh forms bdbre' Can you see anything 
different about this one? 

Taku look at the other fbmis uc jitst generated for iht 
application, the create and edit forms. They have Helds that 
match the fields of the CJietnWorkout model objects. I lir 

difTegrri [: e ihh lime is Hier^'s na mod^l objeri thai maid 郷 the 

saaKh fbrm, So how do wt、create a fortii when there’s no mode! 
to b 批 o liie llsriii on? 

The search will need a new kind of form 

\Vt* ri^ed L(^ creaLt' a form Lvitlwnf usinj^ a mcjclel uljjtfcL I>UL 1.1 it' 
foriu_for hdpur wc.w been mu\g rt.quires needs a model 
object to work. So what do we do； 1 

I^ortuiiiilely Llitfrr is anotht'v liulpct tag lhaL ireitlcs iiioc.lcUfrL , {_ i 
forms — what we need ui thk situation. 
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finders 



Searcli Form Magnets 

Youll need to create a search page template. Trouble is 一 after 
working out the main part of the code on the fridge door somebody 
slammed the door and the magnets all feU aff! 

Fortunately the code for a non-model form is pretty sim-ibr to a 
model form. 

Can you figure out what the code should took like? 


su 


a 


<%= %> 

<%= %> 



%> 






you are here ► 
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forms without ; 



Searck Form Magnets Solution 

Your job was to take the magnets and assemble them into code to 
create a search form, without requiring a corresponding model. 

Did you figure out what the code should look like? 



^1*1 七 he 


No is 

htta^e there isn't 


theretcire ng 

Dumb Qiiestiotis 


/ I don't get why we can t just use 
scaffolding on its own. Doesn't that give 
us everything? 


Scaffolding only provides basic Create, 
Read, Update, and Delete operations. Most 
applications will need functions that go 
beyond basic CRUD functionality. 


Qj Why didn't we u&& scaffolding for 
the IVIeBay application? 

Wedtdni use scaffolding for MeBay 
because we originally only needed a basic 
read-only applicatbn For really simple 
applications it can be easier and more 
efficient to create your application manjally 


Could we still have generated the 
application using scaffoldiing, and then 
removed the operations we didn't want? 

: Yes, ^ could have done that. Yau 
will probably start most applications using 
$caffoldirsg. Only in cases where you 
r>eed very little fynctiofiality, or where the 
functionality is very different from scaffolding, 
will you want to create an app manualty 1 . 

So sometimes it's best to start from 
scratch, and other times it's best to fix 
the scaffolding. Which option ahouid 1 
use when? How cm ! decide whafs bast? 

y\"Gofor scaffolding if youYe going :o use 
most of the CRUD operations, create, lead, 


update, and delete Ask yourself: which will 
be quicker—creating the code manually, or 
stripping out the unused scaffolding code? 

Qj What is a model form? 

A model form i$ a tom bound to a 
model objed. When that sort of form is 
displayed, the field values will come from the 
attributes of a model object. 

o ： And a non^modet form? 

Thafs a form thaf m*t bound Iq a 
model objed. A 咖 -model form is used for 
a set of individual ftefd values and they are 
mostly used far flings like search forms 
or other data that won't be saved to the 
database. 
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Add the search to the interface 


NoH r that we havt* lh^ rode for the searrh (orm, we should probably 
a hnand new page template for it. 



Search is usually a feature T not a separate page n 

Most vvrh siti^s h:i\e a searrli fimrsian bni ]i every s<) rnaylbe wr 

could do like siime. We ujuld add l3itf 叱 ardi u> tJie lop corner of t.m y 
page ， kL ! i p pin |5 die rt^l ol' Llie content on indiv iditii! pages iiitat L. 





〜ary P 吵 ■ 


up 


..and kcc^ of ^ 

as ii aWcady 


Adding code to every page will mean there’s a lot of duplicated code to 
l>e mabifained, hui uliai if vn could add the new searcli code just to a 
single file? 


^Jharpen your pencil 


There's a file we can add the search form to so that it will appear 
in every one of the pages in the application. What's the name of 
the file? Write your answer be-Jow, 


b » + »• F 
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iayouts 


^>arpen your pencil 

Solution 




hd You incwiC^b'f^ ie 

ViCY iortxBn^ 

u,—V 0 A 4 £ 

VCr 1 r^ 1 j'*- ^ 1 


There's a file we can add the search form to so that ft will appear 
in every one of I he pages in the ^pplkatlon, What F s the name of 
the file? Writ 旮 your answer below. 

a^f/ ^I^vjs /1 ayou-ts/^! 咖 七 — 如 ovk otits. i frb 



Reapy Bane 

Ow 


This is the code you need to save in the 


This is 5 layou^ f“ e 
^ *i lives i n 


岬 p/vitfhMVlsy^ts 


app/views/layouts / client workonts . htinl. erb layout file.. 


Download the file from ： www. headfirst I abs, coru/books/irai Is 


IDOCTYPE html PUBLIC，W/W3C//DTD XHTML 1 + 0 Transitional//EN H 

11 http : //www. w3 . org/TR/ k html 1 / DTD/xhtml 1-transitionai * dtd ,T > 


<html Kinlns= w http;/ /www.w3*org/1999/xhtml 11 xml; lang= H en" lang= n en n > 


<head> 

<meta http-equiv= pl cnntent-type ,r ccntent= p, text/html; charset=L3TF M ? n /> 
<title>Cl ientWorkouts : <%= controller, action name %x/title> 


<%= stylesheet_link_t 彐 g 
</head> 

<body> 


scaffold 1 %> 





<span style= M text-align : right ,r > 



T^IS is o\Air P^cw dpde 

W ^6 Ur. 


<% form tag "/client workouts/find 1 ' do %> 


<%— text field tag :search string %> 


<%- submlt_tag "Search 1 ' %> 
< % end %> 

</span> 


厂 


Thu be used -for 


<pi style= T, color: green f, ><%= flash [ : notice] %></p> 


<S- yield %> 

</body> 

</htinl> 
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database finders 



Gkmgc y< i-ur app's l^yotsi to lnduck L the scinch fuiictionaliry. il wu rd \ r$h eacl'a of ihc pages 
in your application, the search (leld should appear in the top-right corner. 




ir r rh^4Hvtl4 




. T _ —a. fl F rr Ak, 丄 a a ^b. 钃占 JL. 

Listlnr , r， pp ,, 









TraifMr 



Our 均 -added 

field 矸 fears 
^tvt l_k« 加 


on C 9 t^ ^ 


_ *' e 


I <i h- ■ ^ 


* Qp 


Sir ft Elf 


剌 M. 


Ddtv af wsrhnuQ JWj 


P 414 % 


New client M^orkoyl 


Mmut Ubt 


Editing client_workout 


IX 


But how do we get access Uj ihe contents of the search Held? H^re^ the 
HT,\fL that was ^ncraterl within ™ ■: h page to produce the searrh Inrm ： 





<form action= n /clienL_workc>uts/find p, method= T, pa^L M > 

< input id= r _search_string" name= H se 彐 rch_string ,f type- M text 11 /> 
<input name^^commit p, type=^ f submit r _ va 1 tie - +, Search" /> 

</form> 



Sharpen ”ur pencil 


m. 


Given that you know what the HTML for the form will look like^ 
what expression do you think you will be able to use within the 
controller code to get access to the contents of the search field? 
Write your answer below: 
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usb the 




Sharpen your pencil 


Given that you know what The HTML fori he form will look like, 
what expression do you think you will be able to us 癒 within the 
controller code to get access to the contents of the search field ? 
Wrfte your answer bebw ： 

. h …“" 

'wo^ld ^Iso but s 

better style io use a symb^ 


So are the form parameters structured differently? 


The £om_£or helper we used in the previous chapter creates a 
model form lEiat is. an HTML form based upon the attributes of *- 

mcxlfl nbjtTL Wlu-n a nindet fbrm is 川 limilldL Roiils kiinvvs ihaiymj 
iire pn^bLihly to want Lu Lurii i[ v\ h liifld Viilutrs Imck iiiLu a imidel 

object. Rir example’ when die scailoldcd Edit ibrm (which \% created 
with form f or j h suhniiMcd, it smin hires its para met er$ like this ： 


U ^ ^nict^h of 

(It . 

rrt) 


evt 




如 r 懈 ？， v 



TKtse arc pra” 二 
a J W 〜 ^ ,p 


With a model Ibrm, you can g^t a hnsli ot all of (h^ lidd values with a 
simple like params [ : client__workout], 

But wha ： abom the f orm_tag helper? form 一 tag creates an nan- 

model iarm* I ]ii"’s :i tlia* h used ro rr]U sm "「individual 

field values. U *r ili』u reason, lilt 1 stvirdi f< ym\ (vvhii'h is crealed wUli 
form taq) rifidcs rrqutwi purameliTs slimtsiin/d \ikt M lliis ： 






ir 








LWt 



^z^i7rt 


t Name 1( Value l 

t controller 

client wDrkouta 

;action 

find 

: search jit ring 

| Kirk Stigwood ^ 


3 ^ 

J -^5 ^ktd 
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finders 


Next, create a find method in the controller to display the contents of the search field Hint You 
can display a string in the console window using the command. 


The form is going to be submitted to a path called /client_workout 3/find The 
default routes in con fig/ro ites ■ rb wilt be able to map this route for us. Highlight which 
of the default routes be y&ed: 


map■connect 1 : controller/ : action/ : id 


:s <string> ㈣㈣ 5 m 仏 6 卿 如 


Now that you know how to retrieve the search stnng from a form, it's time lo build the server- 
side code in the controller to do the search To begin with, we will just display the value in the 
search fie id on the console,. That way we can check that the form is working correctly. 


map _ connect 


1 controller/ : action/ 


二 ormat 
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use puts rot res 




㈨ need ’ _ 今 map,connect ■: controller / : action/ : id f 

Create 3 rou^ ^ map. connect 1 tcontrollei：/ : act ion / : id,: i ormat 

default o^e Will be ^ 


Next, create e find method in the controller to display the contents of the search field.. Hint: You 
can display 扫 string In the console window using the command 


puts <string> 

THU will disylaY Ue tbnr^ m 咖如 
thats 州 tr 


Now that you know how to retrieve the search string from the form, let's start to buNd the 
server-side code in the controller to do tti& search. To begin with, we will just display the value 
in the search field on the console. Thai way we can check Brat the form is working correctly 


The form is going to be submitted to a path called / client^ workouts/find The default 
routes in con fig/rout e s, ub will be able to map this route for us. Highlight which of the 
default routes will be used; 


def -Pihd 


nil netd 'to do h 
out bit 
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finders 



Let's iry the ccxlo out. In <\ny of the pages ii] the- app]kation ， enter s-amc 
^arcli t^xt and dick the “Seardi ’ button, 



Dem i worry iJ you get an error when you press the search brnton. It’s 
simply becaiise we haven 7 t created a search results page template yet. 
The bite rest i ng output will be in the coTisole ^vhere you are nmiiin^ your 
weh server. JSmnewlw : imidni a set of ernm about lhe missing i^suhs 
l^mplaie, yqti ^Kould st?e Lhis: 



Fifes Edit ^ndqw 


Rendering client_workouts/show 
Completed in 9ms — (View : 4 f DB: 0) 
clieot^worjcouts/I ] 

Lenny Goldberg 


200 OK [http://localhost/ 


Processing ClientWorkoutsController#find (for 127,0.0.1 at 
200a-10-13 22:00:40) [POST] 

ActionView : : HissingTeraplatie [Missing template client workouts/ 


So wtAre ^ rfiilt'd a stMrrh form oil each p 叩 t 1 、 elikI \u j hiLve sonit 1 rods 1 
on the server tiiat can read tlit strii ig (Jitf u^vr suarchiiig Eurm. 


Now we need to actuaMy do the searching^ 


you are here ► 
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review what y- ：u f:i \ n a- 


BULIIT POINTS - 

_ Applications often need to do more than 
create, read, update, and delete records. 

_ You will need to design your own page 
sequences sometimes—and the easiest way 
to start te by considering the users point of 
view, and how they'll use your application. 

_ If you need a form that doesn't match a 
model object, use form— tag instead of 

Eortn fo r- 


You need to use _t.ag fields with a form 一 
tag form. 

params [: f isld_name] will give you 

the value of the field called : fteld_name in a 
non-model form, 

puts n A string * 1 will output a string to 
the console. 


tiiereia 

Dumb 


lire no 

Qiiesti9i)S 



When would i use a form tag instead of a form for? 


Use form_ tag if your form is going to be editing data 
that s n-ot stored in a model object. We used a £i i rm_Lag 
for the search form because there was no modd objed to with 
a single i.nq attobyte, 

Q ： Why are form far and form tag helpers surrounded 
by <% ... %=- instead of <%- ... %>? 

The form helpers are used with scriptl&ts (<%...%>) 
instead of expressions {<%=..%>) because they do more than 
simpfy generate HTML, Remember that we used scripttets for 

for loops? Thafs because a. for loop controls the contents 
of the code in its foop body. In a similar way; forms p oontrol H the 
HTML gsneratfcon of IhB field helpers friey contain. 

Q ： That sounds sort of complicated,.. 

j\: That's OK—yoy don't hav& to understand it all right now. 
ff you just rememb-er to use f orm_f or and f orm_tag 
with 5 criptlets 1 everything will work fine. 


Can 1 still read the individual fieEds in a form for 
_de| form? 


l\l Yes, The form ie!ds for Ihe client„workout forms 
can be retrieved with pa rams l : client _ 
workout] —and this is just another hash Soto 
get Ihe value of the : rainer field you wouidjust use 

params[ : client workout][itrainer]. 


Q 




^ We used a ddault route for the "find" action 
Couldn't we have used those b&fore? 


Mo T The routes that we used before didn't match frie 
default routes closely enough. 


How do I know when f need to create a custom 

route? 


If you lype rake routes at the command line, you 
will see all of the routes availabJa In your appEication. II none of 
them match, or if th^e's a route that matches the wrong action, 
then you need to add a custom route,. 
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dBtBbBBB finders 


How do m find client records? 

So do we have a problem reading ihe records for a particular client? 
Wlien ur'w rr.nd ret:ords liir’ tUmv it by re[Lirriinjr a ^in^le 
record^ nr Ijy finding aH tiie i>-coixb in a table. Bui wluit’s cliifbrciil 
this time? 


❶ Reading a single record 


O Reading all the records 




Thfs thne. we 的 out to read records that motch a 


We can read a 
sfngle record using 
the value in the fd 
column. We know 
that this technique 
returns just one 
record because the 
id number is unique 
for eoch record. 


ClientWorkout 
find(4) 


Client'.Vorkout 
find f : all) 


If instead of passing 
the id number, we pas 沒 
the special symbol 
: all; then the model 
will return an array with 
all of the records m the 
underlying tuble. 




Reading records that match a 
specific criteria 


if w£ ?3^ s 

命七 ^ l 5 «- k A 


specif c search criteria We may want to return 
more lhan one record, so we need something 


that wfll return an array of model objects. But 
we don't want a model abject for every record— 
only those that match the search criteria. 




Think about the data in the underlying database table. What does it mean for a 
record in the table to match the search criteria? Is there something that would be 
true for matching records and false for the rest? 
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needle in 


We only need those records where 
client 一 nawe s the search string 

The iraint： fc rs want to search lor all of ihc workouts lor a parilciiliir 
aistom^r, Tlv mode! will need a simple tef；i that will be irw lor 
matrhinsrecorch and raise fhr the resU Snn^thin^ like this: 


Is ClientWoiitoutclient_name - parama[:search_string] ? 



f hts is what ^ ct>itrcd 

in iMt icarth Jp_Hd. 


II tlu 1 iii'jdt'l can apph tluit test to each cjf Lilt 1 ret'oixk in [hr it will 

llnd all of llic matdiiiig records In ihe table: 



In genera! terms, then, we need a tinder lhat can llnd all reccuds that 
have a particular value in a particular column in the table* 


la ClientWorkoiitcllent namie ~ 
params[:search_string] ? 
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finders 


There's a finder for every attribute 


L<hs of applications need to Brid all of the records With a ceilain valise 
in a diit;il ： 3ast j mlLmiiu> Rails nii ； ikt fc s that rmllv eas' Ui do. 

Bill how? I he nind^l codp has a finder lor mrh of il s aUnbutp.s, 
You don^ need to add these finders yx>urself—Raik provides them* So 
tlir Cik : nl\\ r <j ： rkoUE. niodcJ Iuls finders fut \hv clienl imint% ilw worki.>ut 
dm a don, and so oil And each of these finders ic turns an arrav 

r j 

amtaining all fir the matching QkniWorkout objects. 


sT 


T*hciC A'rc finders 
modtl st-bribiitcs 


■tfr 


find all by date_of_workout t 



find all by client 一 name 


find_all by trainer{ 


了 he +iridm an Artri-： 

objects. 


f md 一 all_by_paid_amo 如 t ( 

J 一 




v/ou put the 咖 e 丫加 r 

_ ■ r i 

the FarewiKcs^cs Kc« 


Remeniber thal an attribute in a model objeci maps lo a database 
rolumn in the unr|c?rlying table. So eruh of theKc iinder?i ran be used to 
find all nf the records with a particular value in a particular column, 



Sharpen your pencil 


Complete the code forthe nnd method, 


def find 


^client workouts 


end 



li are her 
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find atl by 



Sharpen your 




ur pot 
Solution 


1 


Complete the code for the find method. 

叫 W looking -fc^ dient na_es, 
so wc use this ^inidcv 


def find 



(^client workouts = ClifitSrt/cwrk^t fil_bv dlht Sinsf scardh^stirih^]) 


end 


ii ihc name the us 饮 

iintc'rtd in %eArth field 


So whafs next? 

Wt- nou ha\ e code that will Hi id idl of the ixicui'd s il uit maicli the sc;trcli, 
so now wc need to display the results back to xhc user. But how? 

We need ta create a .erb page to display 

the search results. 


Is C11 er>tWor hou t. cl lent name - 
params^search stiing] ? 



We fteed a pa^e -for 

di^ldym^, £hc 
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Create a page template for the find method to display the list of workouts displaying: 


ExetiaSe 


<Trainer name> <Workout duration> <Date of the workout> <Amount paid> 

Hint: The index page scaffolding already generated is similar to what you need to produce. 



you are ftere ► 
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display the 



Create a page template for the find method to display the list of work outs displaying 


EseeRciSe 

§£>Lirtioi| 


<Trairier name> 〈Workout duration> <Date of the workout> <Amount Daid> 


Hint The index page is similar to what you need to produce. 


is 


■f answer 


dlitfit wc^rkwt^ -foir <%— ph sttrin&l %></hl> 

BJJJLBJJABUJJ.L hj tli L L K a X L li LliliSLiklBBUBHIV »■■ ■" ■■BJJil •邐 Bjljj ■驪臞 JJJiBilJI 矗 n - !!. t 覼 J L II ,A> ■■ F __■■■_「■■ J J 




<hr> 

<-b^>Tr5i ner </ 


<th>Durstion m\n%</ -tK> 


<th>Ditc of ^wcirkoii ■七 



</hr> 

#• + P ■ d -I h i d -1 + h fl d 4 + fa fl + t* fa B fl + -«• I: i !§■ + l! fa ^ + P B q + + -F B 9- + + ■ e §• + + ff B + H ri i + i 1 si d + -fa i 4 + fa B 1 + -Is fe fa II + -Is l! il + R S ^ + 4 

HS+ + -P19- + 4 i -ffei- s l--f i B4++Hrid«liHd4'«sEa!l-+libi-+l-kbfr+tka+-PaB+ + 'f i -flS s !-+PBfl+ + -fl 

<% for ihcnt in (^dicn 七 workwts %> 


diicnt ， workoutir %></ td> 

b ■ v ■ ■ _ • ■ ■ ■ 灞 ■ j ci 嚙 ■ ■ a a n ■ ■ d ■ oi 濯■亂 丨 t ■亂 __. 瀾 _ ■ ■ h ■ 瀾■■亂 j> ■ t ■ ■ _ ■■亂 n ■ ■ v _ •■ ■ ■ 

二 h dl*lr5t iQti mins %></^> 


<tdx%=h dlicnt ^o^rkou-t d^te of wc^ko^t %x/ hd> 

i* + + ， » s «*ft;.d!i + Frifl++l!fl++l!B4++feB#+ ，■黼 + +，•■，+ +■_ ■- + + i ■« » 'WV% riri#+l<Bi + feia + l-l'bri++fea^-i' b n i i+ + 

< , bdlx%—H C 1 ^nt_wo^rk out 1 %></^d> 

■ # ■警 + F ■■■+ + ， ■ 寺 +kri 警 + +■#+ + «■ + + >fc»+l>feHi+*PB s l> + .R9 4< +，Pq 斧 +P ■■•，+ «« 

<td><%^ litnk {0 workout %></ ^d> 

4- + +B14 + f ■’ «§94- + #11+ + +§!!1< + +19» + # t 1 !• + +Bfl-8-#"q*>«)P"4 + PP«'>l-|iPB^i8-PP# + +iriil + f 

link to 七 ' cdi'i dlient wo^rkc^t 

link _to d ietii _woV kouij ： Con-pirn* —> 

k 9 + + + i # + +« B d> + + h i + + ■ ■ 4 + # fl a a + # ■ a. # ■ p, ■ it ^ p p q + h B + + # i 9 + + -ii e i + + > ■ i + + i a 

wcrtrkc^t) %></ hd> 

f\rt y<xi x 七 hod —> : delete %>^/td> 

</ir> 

<% Cnd %> 

</tA\>k> 


there tore no 

一 Dumb (vHiej^tions 


(V 

、二 * Could we have re-used index html^rb for this? 

l\] Hie client name is missing from this tempSate. so it 
isn't quite the same the index.htm!.erb template. But it 
is always a good Ideate reuse code where you can.* it just 
wouid^t have worked out in this ca$e. 
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finders 



r^Si 


Tqst Drivs 


Tht search ftmction should work great now. check it out 


rkoyts index 


http7/locitho^t-3000/dicrit_wpfkoiii? ■ Q,- 




IjCitny Cotdbcrq 



dnt_ workouts 


Duration 

mins 


Oste of 

workout 


Fa id 
amoyrtl 


60 


2009-10-05 50,0 


how Edit Destrov 




5 troy 


€ 




Listing cllent—workouts for Lenny Goldberg 


mUhn nw« 加 t* _f iw^rN. ^ t 1 1 u _ Htinjiti 


SL'ST l t 

bvc Cwrov 
ll_ biULgflAii'Ux 
)Lu_e LJ.1 QljJiJli 
: ifira _ UuL~ai 





iE Eh i\ 





o 


X redly like the apptkatmn, but I need to 
search for workouts by tramer name, tos, Dkjl I 
forget to msnfion that? 


Lt nny ^oldbcr^^4 


O 




V 备 IM _ 

Haw will this change the search criteria? 


you Bre hBW ► 
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match this OR rftaL 

We need to watch either the client name 
OR the trainer name - 

I he seai'di works l>y fmdijig all the iwords vviih a particular client name. 
But if I he search will also need to find trainers by nmiic% then the logical 
test it will apply to each remrd will need to he a little more complicated. 
Ins Lead of 

client name = paramo[;search string] 


tlu- criteria now neocts to be ： 


cli^nt_naLme^pa rants t : s&arch_string] 
or tfainer^patatns [; se^rch_stting] 




M| 

Wc need tctorA^ Vor 

wot just 


N ㈣ 讲叫 _ htk 如山 cr triers 
bMi hov^ dots that vw^k? 


traihcri 


Can you see a problem here? 

There s a iindt'r Ibr each of the attributes m the model object, y\nd f^acli 
of Lhew fmders has a simple lesi that it applies Iq ihe rec ords in tlie 
datiLbasi.v rhet'kin^ a sin^lr cokiinn bi lUv diilah 收 ■ 办 .™ value H 

But the Iv^i hs rntuT complex iio^v ； so is tilers some way U) specif (Jic test 
lhat die finder applies to the database records? 


Chapter 4 
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database finders 


Finders write database queries 

Ho how exactly does a finder work? What happens when you mu 
one? The finder's job is to talk to the database on your behalf- 
Remember ihm when { ailed, a [micI^t gmemtesrp]cry Ibr ihe 
dalaba,^ in E language called SQI^ (s true lured query lajlgiiiige). 


FinJei^s Up C\me 



以成 ㈣ 



Cl tentVJorkout . f i nd all by t;l LenL nairi ^： ( 1 h^nny Goldberg f ) 


S 令 L % fry 


SELECT * 

FROM client wo 


WHER 



name= 'Lenny Goldbe rq 1 






Pi ** m - I m vmm m -mi h , 

F» 釋 ~^I , i -* 

m^w. ^ 1 ». ” Q 



M M i* 




Tile c. uery is used by die dalKljast' Lu find all of the ntiitthiiig ro\%^ in 
the table.■ The model conwris those row^ imo model objects and returns 
ilicm in an array to the conti^ller. 

Hu givou that’s how- finders work, whai metis to change if wt- are going 
to search tor clients or trainers? 
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take c on fro/ 


We need to U able to modify the 
conditions used in the SQL query 


Wv rid(l some WiVk uf Lclliny ihv hhkIu! Lu gemnm S(,)L C|tiery ilia! 
look^ someihing like this: 


D 


1 want dl the workouts where the 
cfrent_mm£ = "Lenny 6o]dbcrg FI OR the 
trainer name is 11 Lenny Sddberg' 


0 



Select * 



from client—workouts 

where cli^nfc^name = f, Lenny Goldberg” 
or trainer = °Lenny Goldberg 81 


'fihdc^' Ift-S 
you d^diiiow 

£(JL ^y, 



But tiii 1 cniicJilkm.s in (]it fc S( )L uitcn 1 mv ^ru^riiUxI h\ thr fmdi.T niediuLl. 

J a ~ j- 

u r iwv :il>lr lo pass in sttingN h t \hv HiicIilt (iikt; n Leimy ( : "ldlxTg『 r hui 
fbr w l^ivc ihjE clum- anvil ling U « mudify \hr acluul ^Iiue Uli<- n! th!_ 
r«>ndiiiuiis Ihnt b^i imir ]>ar( of \Uc S( r )L ^ m the darab^is^. 

Will Ixing al ale to modify [he SO J, C[uet) pai a meters actually lx i that big a 
dcaJ? VM_ yt 、 i ， will, I'mck that J ⑻ k ft>r iiiiUdiing v“luc、in pariknlar 
altrihntes an j us^lul hut spf^ ilving t\w SQL conditions lets you do so 
much rnort 3 , It lets you override l\w deHuilt hdi ； i\lor of a findeTa rind get 
t “] ii|jlt_Lt_ control ( jvlt llie data lluil h accessed by the inodt , l J Tliat’s jus! 
what \w nc(x\ Ik.it, to<j: mort- control over ilie S(J1, query. 

So how do modify those conditions? 
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finders 


Use .conditions to supply SQL 

Vhc. fin-clt*rs i\vdt cin- grnt'PH! lov cu h "! ihe al(ri：l >inrs ;ire shripk 11 and 
vm\ ust\ t»ui llu k irtJLible is lliev'i.r nni wr\ jlrxihU.. Yuli t AXim ijet'd to 
Eiiatr uisjil' t.'Oiiq.jk'x cjtici io tm (hr c!iital>iist , - 

For reasrm* all lindpr^ allow \"l] lu pass a najTied pHi ameier ("iljed 
: conditions ^nilaniin^ i-xtra <.-«mdiiioii^ to hv adtkd lo ihv SC 之 L lIkiI 
tlu 、 finder gencnitcs* 

HfTr's. ciic \vi\y in whidu litis roi.ikl \wnk with du_ traiiu h i7dit'iil scart h: 


&client_workouts « ClientWorkout» f ind (: all f 

: condLltio^s->[ ,r client name - r Lenny Goldberg' OR trainer - 'Lenny Goldberg 7 PT ]) 

TL m 

J he ^onditiorv h sH~ io an ari-jy 


Fhis vnsi"ii ul tSit 1 [iiidrr u ill ri'LUni nil ol llir rm. 卜 rds Llial liaw a 
iiaiiier «>r clieiii called 'Lennv ( ^ biu can \ r ou sec wlmt the 

problem is? Wliat if we want to search For someone other than 
Lennv? What we mi/fy want i.s if j seftivli Ihv 、 vhnr\Tr is recorded in ihf* 

t m* 

pa rams [ : search string] h Bui Iujvv? 


Fi>min^ieK; Rails w^v ol <knim jn^t thnuli aUnu-s you rt 

(lit 1 ronditions likr lliis ： 


@client workouts = ClientWorkout - find (: all 


conditions=> [ 1P client nam« 


? OR trainer 

M . _ 


〆 


广 P3^ irr.sl ： sc3' 


心 ad d = 


w ? ^ 


params[ : search string]i params[:search string]]) 



I hr in ihr lii、i siriiiy in roncliiif>n^ urray arr R^iiu'tTl in 
st k qutnw with tlie valuta that Ebll<> 、 v. This means lhal I lu k fmder uill 
:i mw 3ie 1<s yvnmur ihv I'orixrt Sf 』』 siaivnii'iU ioi \WiiiU-\ t-r is in 
ih e search paramcicr. T1 k. rclmmt records aic ro turned ibr whoever 
the trainer ?st fc iiR ho Ihr 


So how well does this work? 


you are 
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find 




Tqst Drivs 


L pdato your cock% and t L elaad your application. 
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finders 







The Club h 站 started to record ^dl of ihe gumes played on Uk'u 

oiudcjor I 伽 cbalJ firlc!, Malclj up tlio datalx^e linden \vith how ihcy 
mmhi be used 


Fintler 


Fbrp^ 兜 


BascballGanie . find (: all r 
: conditions->[ 

1 month no > ? and month no 

9, 3] j " " 


ULiim 、 |)bi\vcJ out "r snis«i】i 


BaseballSaiae . find (: all f 
: conditions^ [ 

■month 一 no > ? or month_iio < ? 

3 , 9 ]「 " 


Xcitiiilly shis rjurrv will never rru[m 
mw lliiny, mp it Mon'l lyv uHt.d 


Ba&^ballGame, find ( : all, 

: condi fcioTis=> [ 

1 month no > ? and month no 
3, 9】厂 _ 


JlllL'S 


fjlayrd “i 


sii 


Bas^balXGam^, £ind ( : all ^ 

: conditions=>[ 
e month no > ? or month no 
9, 3] } 


Thb qtifiy ju^l it turns fveryihir^ 

i[ U'nn'i ht 1 ust j d r illin 


you are ftere ► 
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know your 


It 


- ♦ MO0 —4AW— 备，一 

^Vmr job was t" match the Elncler^ up with how those finders 
could I)p u^ed- 

Finder BfrpQsje 

Ba s eba 11 Game * find ( : all f Garn es pLiwd out of ^ecison 

: conditions->[ 
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finders 


Then there's a knock at the door". 

Just its you re riemonsiniling tin 3 sysleni UieR's ;i knork ;it she rlnor. 
ll's some tif tht 3 guys fruni die body building cluli. 


Hey, what's the ded here? 
Somebody^ saying ws hctvsn't paid, and 
they're not letting us into the gym! So 
you're the one to talk to about that? 



O O 




yoi* S^y iroi^ ir 

Anyone? help 

these quys 


It seems like there’s been a problem with the 
data entered into the system … get ready for the 
next chapter，where weMl dig deeper info the 
bodybuilding problem. 
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rails 



Tools for your l^ails Toolbox 

You’ve got Chapter 4 under your 
belt, and now you f ve added the 
ability to choose whether to use 
scaffolding and how to smartly select 
the correct data for your application- 


Rails "Tools 

U 城 : ■]) allows ^ 
认 e S6JL u«d to selctt «£crds e 


database 


。一 ㈣ si«?)e W 心 t 扣 r,oi 

bou^d model 



Ruby Tools 

<stH ^ 如峋 y “如吋伽心 c« s Je 

(the o^e ruhknjj iKc wb s^^ver) 
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5 Valklating your d^ta 






Preventing mistakes 





Everyone makes mistakes... but many of them are preventable! 

Even with the very best of intentions, your users will still enter bad data into your web app. 
leaving you to deal with th^ consequences. But just imagine if there was some way of 
preventing mistakes from happening in the first place That's where validators come in. 
Keep reading, and we II show you how to add clever Rails validation to /our wab app so 


that you can take control of what data is allowed in~and what needs to be kept out. 
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had 


Watch oirt 一 There's bad data m the room 


Everything seemed to he going well with the personal trainers 1 wieh 
app 5 ^iL U h asE Liiilil Lht j buily buildtrs showed lip, The btnily buiklers say 
dicy'w paid their gym dut_% and haw the receipts to pro\e it^ but llwlr 
payments ai*ca p t showing up on tlie system. 



I don't get ft. I entered 
a paid amourit of $50 and 
clicked save, but it r s just 
showing up 0.0. 


So what went wrong? 


Clicking on the aave button should have saved the data into 
llie databast^ I nil something wnil uTnng, Instead of saving 

\\iv amounl [JiLid ms $50, l.hi a iiniOLlllE SilVed AS 0^0. Bui 
huwV Lei's, cake a look ai Lhe tiiLiin of oventb ihiil tJcfitnrtL 


A trafner enters ”$50 ' into 
the paid f feld \n the view, 
and then clicks on the save 
button. A value of ”$50" fs 
passed to The controller. 


❹ The controller receiver 
a value of _$ 50" for the 
ori^ount paid, and it parses 
thf^ dong to the mocfe! r 


The model receives the value 
150/ but there's q problem. 
Since the value codtains o, $ 
symbol, the model can t convent 
it to o number. It Mves the value 



You say pdd_amount 

has a value of M $50 J 7 
HI tell the model. 


0.0 to the database instead, 


it 


ao 




as 


Pa^d amount 


Ciat* 


nc 




The problem vvfi.s raided by the i raiiier nilerin^ lhe wmtig sort of daia in 
die U'<-!) and wr need lo pn j wnl ilm liapppirin^ again：. \W net a d to 

wrkr c(jde to vsilidaie the form data before il.s wriuen to the datiiba^e 

btit u'here should validation code go? 
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validating your data 


Look guys, obvious, The form 
in the view, so the validation 
should be in the view too 


a 


-妣 a ik 中 ks 

& 咿 odd 



Alark tnihKs 
■tKc tOTn-^olleV- 





Sharpen your pencil 


McU'k; \Vhy Adit in；sUcr u li^re ihv vididation is? 

p 

Bob: Wv iix ilu fc pmUem wliere ll luipptm The error lj“pp_】is in itu 1 
IV>nn, so that's wJiere k slioLild hr fixed. 

Mark; \ej - ](K^k-Jusf pul a <Ikh k m llir ron I roller, I ht A rnnlrollvr 1^1 
ihv saw and U] Kt;ik' mtllindH. Wv uiu jti^[ miikt 1 ilu j couLrolltT ;lNl s In 
deckle whether cjr not lo saw ihv object* 

Bob ： But the cx*cur& in the forro, 

Laura: Vm not suit ， Isn’t lire prf>bkm really in the model? 

Mark; Thr nmdd's just da^ B Mosi of Hie ende we write is in tlie 
coniTfsilf r 

Laura: t thought the niodt i was more than just d^ta. Cmv\ \vc pu« 
code ii^ ihtu Ion? 

Marki Him the i lewi' ["gk is iill in il】c (mtrofiei. 

Gob: N«j - ii\ m^iiLT limn that. Ylju just pit^ dijLivaS^riijL diftk in tlu K 
form^ markup. 

Mcirk: \\ hLil if N it 1 us(.T r s switched Jin aSrripL oil m llkcai Lmnvn? 

Bob: Hex; ccinit 3 oru sv^tcht'JdvaSrripi "fF Lunin or in 

Laura ： Bm Iiov\ can vi_u rd' an that J l^iniculailv whesi its olivimis 
whm* iht m rock slmuid go + 

Mark: Hie conmflci, 

Lctura: l lic m< doL 




Where do you think the validation shoyJd go? Why? Write your 
answer below. 
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vafidatB in 


Sharpen your pencil 
W Solution 


Where do you think the validation should go? Why? Write your 
answer below. 


d«kHba should be y^Ud B nsodd K m A+? 矣 I s . ■ 中任 p^ s 'tjic fw^ollw 


Validation code goes m the MOISEI 

The irc-ublf 3 with pulling Vfilidaiinn cmh in the vit^w or ilw rrtmr，>]ler is 
(lull twu : ieparaie biLs rodtf niiglil try Uj y.avtf \ r idat^ U> ihv dcUabiise. 

II we have iiisiiTt and edit mclJiuds iii the controller，lor insts：ince 5 both 
oi these need valid at ion. If the valklatioi^ h centralized m the. model, it 
doe^ivl matter hovv data gers scored — validation on tlint data will will occmv 


Inserting bad data 


The usev cnie« 

bad 

<hscr£ 4^ 


_h the 


The 於七邮 

daia IS tailed ^ 

COTshroWtr- 

Paid_arnQunt _ \ 

^ I I i ； 龜 

o m 


new.html.©rb 



No wriith 

\p ctvtcr d^tj_ 七 ^ wodd 

tin spot cmr 球 r ， 


Ed(trng bad data 




TW edit 於七一 

\s taUed 伽加 
^rolltr 


tow 



ediLhtml.erb 


In general, it> a good idea to validate in the model ,Viid afcr nil, tliai's 
one of the reasons that we km sl model layer. The model kn'juM data. 
The n j ^in we wrap th^ 土 in a layer of codtHs that we c^it add 
ilw kind uf suicirl^ like vulidahun LhaL a t]aLabctst j oil its. imn tiutrsn’L 
provide. Sa how exactly do we add validiiUon to Lhe modcJ ? 


190 




















validating your data 


Rails uses validators for simple validation 

Every sydH” perli ttii ^mu 1 kind sif t lirrk nn sht* cbi；k thac 

rrucR'd inlii i [、 iuul soinrhines ihtM lirtkin^ emit* mi] l』r 1( nt^ aiul 
n >iuplic Lik'd. 

So wi\a\ c^u Riiih ch> to help? Alic-i , nil. the diccks yrm nerd h * makt L mx. 
preHv customized, aixrn t they! Well - ve^ and no, I he set of validation 
rules for your rlnta will probably he unique to your system. Bui ihf 1 
iudividuiil rides thcmtjjelves will probably rlierkins for n sniall set of 
l\pir;iJ t!rmi、like missing data, (ir in \hv Wrong format, «ir datii 
of the wrong type. 

Hill's uliy R^iln ronu j H will) a srL tA Imi [ 卜 in sbuuhmJ t hrt ks t ! alk'<I 
vulidiitors. A dlkhtnr Kuh\ ol ihiit looks at tlir (IllUi n_)l” lm\v 
mtered and peribrms a simple check on it. Wlm dues ii dn the chock? 
Wlionrwr sunn: j nnr nie^ \n saw nr updme ilie data in i 1 k i tluuiriii^^. 





VVilkiaM »rs Lire a quick and eifrriivL- way [>i mi|)mvii】g \hc f[Uidiiv n\ you! 
drita + Th'\ will help you (liter what is and isn、allmved imn \rnir database* 

j if p 

AikI in [lie i'\m h s whtTP the data is hack e1h i v n r il t vwn pm vide a sri uf tTror 
iiiussajrt ii to lieip 11 if li^vi tiiagi'KJse wliiiL w vnl U fonff. 

But how do validators work? 
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you are hero ^ 







vatidators 


I ji 


So how do validators work? 


Let's. Unv ii Cilienl^^Virkout a^s it tliyolijrh a MiJid:tlk>n st-qu^ncc 



The user submits the details of a Client Workout, 

"rile problem is, tht. pa i d amoiiri [, Held raiitain，s ^" L rather kt 3f)' 
and "$S0 7 ' cau l be eonwrlcd to a iuimerk: value. 




The controller converts the form data into a ClientWorkout model object. 

The nintlel ohjec 1 stores a copy oi [Ju* Ibi m dfiUi^ ami it Lts^s lliiit Lo ^rneriile die \ r alnt^ of 
its HUribuin 1「 ytiLi \liv object for liic ViJue uJ iti?i paid amount atu^buiUj h iHd Uj 
convert the td fi50'' to a number, hut can't, so die controller says the paid_amount is 0.0. 





nc ^hr Q l\ Cr 

iKc 
仏 ‘a 


CUrk^ Vo ^ 

IM ^ 



Thft controller tries to save th^ object, 

1 he comniUer a^b>. the model i »!? ject to swe ii^eli". Orclimuily tht nlsject woukl 


save a iecfjixl ol ilselJ to tlie database with r paid amount value ' OXJ, BiU 
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o 


validating i : 上 


The model object runs its vdidator(s). 

U hen the mtxld object is asked to inseil or updace a rect nx] 


to the database, ir first nms its validators. The valicfatorK 


check the values in (he i 】 ]ul(.] h iriu. ii?rm cIjiejl stored inside ihe 
ClienE\\brk()Ui objt'cL Our pd i d amounl. siilidaloi records 
error beciiiiso "S50 M not numeric. 







LJ 


， I 

worhcfut a" 




of 


iU.LiB 


F»Ld 



Hmm, $50 Isn't a 
number. T il make 


an 


of that 


note 


a 



Errors 

Not a Number 



The model object decides whether ft*s OK to save the record. 

(>nEy after the validator h^vs nni will die mod^l object decide if ii ran wiw ihe 
j'^tord lo ihv daLahcLse, How tines il decide? 】i looks io see if rinv mrs \rd\r l>tw 
crouted. The paid— amount validator failed m the model skips saving a record 
aatl tells the controller ihat something went wrong. 




Errors 

Not a Number 



The controller returns the user to the form, 

I hv code in ihe controller knows lhal Humflliiuy ： ^ cm wrung, so :t returns 
I he u^cr to the form page m that the emirs can bt conoctccL 



Paid amount 


广 Cr«t* 


Boick 
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VBtidBtB nutfiBiicBiity 


let's check if something is a number 

We’ll i'herk ilie paid_amount field with % r alidHlor called 
validates numericality of. Tlit* validator wiJ] belonir Lo a mudel 
objrcu so we need lu ctdd it to the model code m client 一 workoutrb: 


io iec 

fldd ^ 叫 metA 


class ClientWorlcout < ActiveR©cord : : Base 





validates_siumericality_cj£ - paid—amotmt 

end 小 


THb b the Aeld 


Tills will creaie an instmneni the \aiklalor for each Cl lent Workout 
object. 

The valKlaior needs the name d die amibute it、going lo clieck. Like 
pretty much all namps in liuby, xlw aitrihuie natnr k k givm as a .[vmboh 

;pa id_ainoun t, 

Remember ihat a symbol is a little likr a siring, SymbolFi always I \r^m with 
a colon { : ) and are generally used to refer to the names of thinp, like the 
nail]of liflds arid ^Ltribotes. 

So hoctv will this all actually work in our app? Let's say the controller has a 
CJi^tnWorkout iTindel uhjert called @client workout, 

Whenever rhe controller calls @client 一 workout, save or 
@client_workout, update 一 attributes T ih^ nmdH ohya will run 
Liu - a IdaliGfj niimer i ca 1 ity of vaticJfiUjr. 

If the original form data inside the model object has ‘ c $5CT recorded 
耶 ] in si the pa id_rj mount Reid, the validator will generate an error. Rails 
will spo ： Uie terror imd L the daLilnst_ updaLtf. 

ThaFs the theory. Let’s see if this all works. 
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validating 


Now ihai ihf \ r iilidai{)r 5 s in plart% lei's n y ilie mu 4 HtTe s whai happens now wbrn \w trv to 

iiiserL a nfroixi with had d^ila in the pa id amounit field: 


Were s {ht jNW 

F 呼 

如 QMh 七 >f f^O 

i h 

F^ 1 ^ frvoun 毛 

■field- 


« ^ n 


C.lien^orkoLit^: <^eate 


CfeUlRflffcHU ITH 

• ■ irn^crJMCJMI^ltiHLiL^viijpiiiijAALihvP : 


New client workout 



T ht' ' l $^n' L value is noi nument' 5 so an error nieHsagf ^enfruit'd, the wni'kout h not sa\ed lo 

ilm dalLtlKist\ anti ihv ust j r h returned la ilw lijrm Lu t ormL llu 1 tTror. 


Sc? whai abnii I [he Eclii p:igie? Does ihi 1 ^ r ; I id 31 or work 1 her*' loo? [: shnvild, bt-rau^^ 
will call eXHJCtlv thr simw validaior when someone tries to u：jdate a record on the daiaba^. 

„ p ■ 


Ths ii^e ki f 

^7 ^rth ihe 
EcH pa 


pa 3 f_ 



leRtlng! c3l*f i tt_worl(oyt 


That cleared 叩 the 
issue with cl rent' s dues, 
but IVe had ^ome oth&r 
probkm^ too … 


Editing client_workout 

were m$ wl|fi cht fQllD^lmg flel^Ji: 


^jld iSmourst i _ 4 n>cd i tiiJlviAH , 


；i \mii nafTui 


Talk albeit 


n 


O lPJitWi>tk rmt-s- u pdate 
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fBQUif&d fiBfds 


Users have bew leaving out data 
on their workout forms 


Somt* pfopk ;mt ha\T been leaving fidds blank, Ff>r example, one »>f 

Oie iniinprs has lx j eii Ibr^Lling la filler his own immt- on sonu* or (lit* 
uorkc jui^ Ju.’s Lcittr 1 ) 11 ，when hv searcht.s ihr idl of tik own 

workout, he can’t find the ones where he left his name off. 


^ n 


[ItimTWDrlk 口 uts : 




■L ■% J i - L V-j \ P •- J - ... ... . . - , 

i.. O J 1 ^ 1 , i +1 hiip ： i r /!ocalhSiSi.!3 , M0/tlpt*T_i*tjfkou[s/new ff - » 

3 *^™ nra * SS ' !a!r!a# *' _ ^ SMEr —aT —1 r ; : -— - - —. :' : -：：：... --- ? . -=_ 一-工 ...'--- 一 - *" m 




New client workout 


OS_AC 
OHd fifra 


PFi 


aids a 

W David rt^ 


t iim rTTlJifli 

~~ } 

il 

^4(4 of irr^fl<-vut 


[am^it | h*wmm# $| 

6 * w ： 

Pal, flrpwMiW 




Sijtstc k«ps 

{o 

chter his name 



J\；it is ^ yt 
^Mtrs search W ^ 

^ ^orkouib …㈣ 乞 

如 w DaV'd 


cme wl 




#• n n 

c 



d_n 【 ^i'£H.kDu[s: find. 
ICdlhOhl: 




Listing client 一 workouts for Steve 

T ra 0 gr#f t^n mhnm D«tv «f wrvrkayt iftlcuHIt 


£4wfl &Q 


2QH - 1 (.-Hi 

2 m ti i2 


□ 


麄 0_Q 


SUp^ tdiE Dflitrc-. 

S»pft- ,.dlt Q^atrmf 




go * 叱 m 


啼 w ih e 


h 3 


And not only docs tht- trainer's name need to completed, blit the dknt’s 
name as wclL Lenny (jufdbrrg liad a couple < >1 sessions when? hi^ name 
wasn't reenrded, Lenny nornialJy gets billed ai the end of the monUi, 
whm ih^y searcher! for his train mg sr^sions to linr! whirh "nrs didn't haw 
paymenLSj \\it T y couktn i find lli« i ni, I lie person id ir^iiKTs jusl c^n'l aflhrd 
for this Lo happen! 


So can validators help? 

So ilir, we_ve niily usftl a vaJidau>r lo rherk and s 汁 if ail iiipui sTilut 5 is 
]ium‘:dt\ Bul Uieie's a whulu fkmils of v r ;didaLors iluil can do itiryihiiig 
from checking that a vakic km a Ikt, to whether a vvtlue Is tmkinc In n 
particular column in a table. 
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vaiidating 


How do we check for mandatory fields? 


I it vaiidalor \vc t ： L-m use lo tlieck for values iii iiiantJaloiA field's, I hv 

\aIidntoi that docs this is validates_presence_of: 

k 

validates_presence_of : field 一 name 

Her*e s s the code with the validators hn place: 

class ClisntWorkout < ActiveRecords : Base 


validates nuraericality 


paid amount 


validates_presenc^o£ : trainer 
validates prasonce of : client nams 


inio 



snd 


a PP 


ijicrcia 

Dumb 


are no ^ 

Questions 


Tht ^ 

ilh£ m9SW 




U 






-i ■ 'H mIiIc.# 1 
IL J- 衫辦 

LhaTC 切。 - 琴 

j,k f +rai^ 

tnc , , 

I.. L Ab-# tdTnV(C\^ W 


0/ Ifa validator fails, does the model 
object run th$ oth^r vafidator$ anyway? 

J\l Good, question: yes Even though 
the model object will know after the first 
failure that it will be able to abort the save 
operation, the model still mns the other 
validaters before telling the controller about 
any failures. 


Q" Why's that? 


Imagins you hav@ made sevGral errors 
on a form. By running all of the validators, 
the nnodel objgcls ensures that you see all 
of the etor m 的 sages, so that you ean fix ail 
of the rrors before resubmitling Hie form, sf 
you onlv ever saw frie first error, you may 
have to re-submit the form several times. 


Q ： Why does th& model object keep a 
copy ol the form data? Why doesn't it just 
store the values from the form in ordinary 
attributes? 


J\l The model object needs to run 
validators on the original strings submitted 
from the fonm, If, say, it stored the pa id_ 
amount value in a numeric attribute, 
it would have to convert the value to 
something like 0,0. That would hide the fact 
that there had been a probtem. 

Q ： So when 1 ask a CtientWorkout 
object for @c I lent workout, pa id amount 
i&n ? t that returning a proper attribute 
value? 

What the @cl i ent workout 
objacl will do is look al the value of the 
submitted form-field [ M $50^ and then return 
a numeric version of that It will do thal eath 
time you ask for @cl ient_workout - 
p^id_ajnount 

So is that why it saves *S5(T to the 

database as 0,0 ? 

Yes. If there are no validators, tfie 
model constructs a SQL iMSERT or UPDATE 
slatement from the attribute-value of the 


model object When it looks at tfie value 
of ^client workout * paid_ 
amount, the value is 0,0. and that's what 
gets sent to Ihe database, 


O * C^n I ask the model o 


validation? 


bject to skip 


Yes, If yoy call @c l i ent_ 
workout* savG (false) it will save 
the object without running the validators. 

q ： Can II change the error messag&s? 

A- 

r\ m Yes ■ you can provide your own error 
messages as an extra string: 

validates_pr 0 sencG_of 
1 1： rairier, "Where^ 3 your 
namW 


(V 

^ / How do the error messages get 
displayed? 

There is a tag in the form called 

f - e rror_jnessage^. Welt find out 
more about the process Eater on 

you are here ► 
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test 








Tesr Driwq 


Lt'fb fire ttp a Ijrovvser kind Iry to eiiUT somt' l 腿 1 ilala im<i Uitf I'omi. 

I loprfulJy, our new \ id id a tor lucIc wilJ catcJi any prubl^ms. 


mr\n 

< 4 inHnb 

l * 1 # ^ ， + 


nnn 


ClienlWo^rkouti: npw 

hcip:.! 1 / louthDiE ： Ii ； QOD/cliffni wcirkci4J ： tt/fi«w 




OientWorkouts: create 
http:/ f local host: 3 00 0 / e f I e nt_worko ut s 


New client workout 



New client—woricout 






o 




























































validating ] .h 


% + 

• + 

Wc rm!\ iitH-(k"d k ， cht't k a rouplt- Lliiiiys lin - [\\\n HVstenu 1 仙 Jcl s see 

what [ ither validators an： 1 泌础 abk*. Sec if vou can u.ru k out vvh；it 

d 

validators wctc u^cd I. u. uhiit purpose: 


valIdates__leagth_o£ : fieldl, 
: maximuin—>32 


validates 一 format 一 of : fieldl, 
: with->/rsgular expression/ 


validates uniqu 白 tisss of : fieldl 


validat&s^incliisioiiL—of : fieldl, 
: in—>[vail f val 2 , .-, r vain] 


Cl^ck tj^t ^ ^}Til ^ Joc-ks like t} 

crejlft Qmd 

C|iecW fjiftt Hlf|^ iTffliJing \VllJ riPt ip 

ij^e 糾 n】e person twite 


Did tiiey s[>ejj t]ie uiiBcIe ^rottp c* ： »rrectJy? 


Cli^W ihni ^ 之脱 rminie ^its cl 

coJmTin 





tots and lots of validators 

-+ M^V —4A—— •«■， - 

• + 鬌鼉 L4^ri 备 ㈣ 

We only needed (o check a cou|>le things for this sysiem, but let's see 
what olher'alidators an fc availiihle. See if you can work out wlial 

.|B 

VrilicJyLors were used「or what purpose: 

Clie^V ib^it a c redrt mctl 淨 J9oks like ^ 

i veSt f 軌 [# 

Clapfk-rjicit a liiaas uirijling \Vill net ^ 
th e s^inje p^rs?Ti twt^e 

V)iJ tjney ispell tlie Uim'Ie 科彳 i)? 

Qh^ck 仏埘 与 os^rFi^n)^ ¥rts int^ ^ 

JqUlUl 货 column 


validates length of : fieldlT 
: maxiitmn^>32 


validates format of : fieldl, 
: with=>/regular expression/ 


validates uniqueness of : fieldl 


validates inclusion of ; f ieldLl, 

— H 

: in ， >[vall, val2 f w vain] 



Validators are simple and work well 

I he data qiiLility is now nuicli lii^iivr, tind workout data has 13topped 
mysteHousIy vimlshijig. I he accc>umam h happy because die has a 
record c^f all (he client who haven s paid and the body builders no 
longer have Us worry alxun ihHr pnynmts gnin^ missing 


Chapter 5 




We smoothed 
problems with the body build 
and because you 


problem so quickfy 
any new is^yes 


the 


over 


ers 


fixed the 


avoided 




Good job 


arrsmg 
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validating 


^^BULIET POINTS 


* Validators are defined on the model, 

_ Validators check form data which is 
stored in the model object 

_ Validators run before database 
inserts or updates 

_ A model object may have several 

validators 

_ The model object _l run all 
validators each time. 


_ The controller should check rf the 
save or update was succ^ssfj). 

_ The user will be returned to the form 
if there are errors, 

■ There are many validators 

available 


Everything was qoim so well untiL. 








validating 


Something strange has happened at MePay 


Fhe tolks m MifBav lizard ahoul \mir work vviih valicialnrs s(i ih^v tried 

♦ i 4 

itdthnsi - l.u j m Ub lIi^ ft iJe vuii'tl ui \i\vn Inf them. 

■!> / ar 


But they dicln'l siu l] a jwl resull,,. 



o° 



Whot happened to the ad for 
my stuffy baby? I 式 pent a \or\g tfme 
crafting it then... boom! No complaints 
no errors, no nothing. But my work 
disappeared into cyber^pdce and I 
ain't seen it sir^cel 




VV 。 叫…产 sa 7 

如 Wer? 


All Me Bay did u^as add i r alidaU)rs to difxk ihai all ihc lields cm new 
were cornpltied, limi] ihni llu* nunitTit and muiil Helds wete 
f( htcciK tbriuaiLed. 

jt 

Let’s look at what’s happening in more detail..« 





mebay 


'ritf- 


The validators work, but they dort't 
display errors 

Someone entered an ad with a blank price to see whar's 
wmng with ihe validators 


❹ An ad is created without a. price, 




vs missing 


Since there are errors 
the record isn't saved. 


社 e fid _Nid 伽社 i 



class Ad < ActiveRecord: : Base 

validate&_presence^of : price 

validates_presen.ce_ of : name 
end 



o The vafidofes_presence_af price 
validator prevents the ad bemg 
created. 


rii!j kj'jyrjui IDSCi'iidi ■ 


❹ Instead of returning the ussr 
to 肀 he form, the system send 笏 
them to the index page at /ad$/ 


So what went wrong? 



2D4 

























validating 




厂 f|i[>arpen your pencil 



Uf an ad h correctly entered the next p^ge a person sees [s the n^w ad^ page. Why 
did RaiEs display the index page ai /ads / mstead of the New ad page with errors? 



■ 



2. The validators worked correctly on the health club application. Why do you think 
they didn't work on MeBay? 








whafs wrong 


Sharpen your pencil 
k Solution 


1, If an ad h correctly entered the next page a person sees is the new ad's page. 
Why did Raids display the indeK page at / ads / instead? 

A ID ii \AavM unfcl fs 公 vcd. blc^r^StW'i iHe ap? ircdurctis io 

H r a a p ■ ■! s«i « ■ ■. ■. ili <■ ■ m 、 q ■ F _ q 響峄 ■ i - A ■ p 響 1 # ■ 賺， . 遍甲 ■!■ ■ ■! « ■■ k Bi ## B ■#■■■■ n n ■■■<■■■.■.,■ ,p 

/ads/<id> 

Be^^ust {ht ad vvash i save 山 the ap-t rtdiirc^cd 4^ 

/ads/<blatik> 


2 /The validators worked correctly on the health dub application. Why do you think 
they didn't work on MeBay? 

TKe Htatth dub 奸 p tvc^itd witH s^aWoldmoi W 七 tkc Me&av ^F? treated manu^llv 

SdaWoia.^ todc dK^dh ^ 咐 0« and di^lavs thd Ui o^ir t^stonh dodc doCSn ，_ tf 

+ 4 >P^ 4 + 4 iPflV 峄 P_ * -P ■ 1 ^ # > + B B 4 fl 4 > <■ ■ ■ V P P » ■• « ■ ■ ■ V # P B ^ # P ■ I 4 1 + I ■ ■ P i » ^ + -■■■ 1 - ^ F ■■■«+■ P f ■+ 4 + ■■ f B »*»■#■■ ■!«■■■ t * «F P ■■» * ■■■«!■ -P P ■■• 4 


I 囑 




TKc Wealth Club afp ^ 

treated 必叫 》 

^ e^a todt was gch^ated 

^ |p dVietk for 


► 





TW m ^ H 17 

without siaWoMin^, so ^ to 
fihetk ^ 蝻如飞 Jtncratcd 

必 “■ amd 喊 ne 败 added m 


or 
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validating < : 



If you build your own pages, you need to 
write your own error message code 


W lien yi >a strUtl part i>f an applicalicjn, Rails generaLes die ct>de ytJii 
need to Juiiidle emirs. Bui if you art, crcalin^; code you'rr prt-tLy 

much on your own. So we need to change the McHay code to handle errors. 


Thu vs ii! kj do two Uiiiigs ： 


If an error occurs, tlie system needs to redisplay the page 
where 个 he error occun^ed. 






Errors? We d better 
redisplay the page 如 
they can be fixsd. 


litw Ad 


o The form page will need ta display dl of the errors that were 
generated by the validators* 



仕邮紙辦抓如 ？呼 
needs {p stiow errov 


So what ! s the first thing the application needs to do? 
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control the 


The controller needs to know if there 
was an error 

II Lh^ user rulers had data iiiLo n form— Rails nt^eds io send lilt* user 
bftck to tlie ibrin uilli ihc cixor. How like Llik is lumdh?Ll liy Lhc 
coji;m>ller. Rcmcmlxr i bat the cot^troller k in chiirge oi what daia is 
read and written and which pages arc displayed. 

What docs the contraller code need to do to handle errors in the 
A leBay a|jplication? u Iim the app aii^rently dm when a new 

ad U submiited: 


def create _ 

|| tkert s ^ error, wc 

aWt -U 


The code wi]J always do the same thing — try \o save the ad to 

ilie 土 itah 訓 a rind \h^n go \.o ;i to display thp daEa. 1i doesn'E 

currently matter if the uve fkih … and that’s a big prublom 
But how do we fell if di€ saw method has failed? Well in Rub\ 

4 

every roumiand ]ias a return value, U a |>ri savijifr 

ail ad，the iad, save command will return false. We can use 
the return value of @ad. save to determine whether we should 
redisplay the page*.* or display the saved acL 


@ad = Ad.new(parama [ i adj ) 
@ad.save 

redirect 一 to Vads/ft {§ad. id} ” 

end 




^ 11 9 ^ b^fe ^ 

… “Nih ， Pg e 


|| @ad.save 
rrUrns. ir^c 


But to do that we need to learn just a little more Ruby,,. 
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validating 


Vm] Puzz]e 



The code you need to correct the page 
flow is given here. It uses a Ruby 
language feature we've not met 

yet — the i f statement. Your job 
is tq take code snippets from 
the pool and construct the code 
needed to correct the page flow. 


if 


〆 


i ■ +争 + ， ，fc F P i I I 

^ it ^ 代如州加 

W ad/r^_ 


Note; each thing from 
the pool can only be 
used once! 



jre riere ► 

































if this, then thBt 



P 細 ] Puzzje ㈣ 叶細 

The code you need to correct the page 
flow is given here. It uses a Ruby 
language feature we've not met 

yet — the if statement. Your job 
h to take code snippets from 
the pool and construct the code 
needed to correct the page flow. 


^ ihe 




::: 沭 —a: 



feti ybv «!f rtnder with 

二 t zr— 一 




{^tr^ rcd—M 


hfw 
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v at (dating m 




Tqst Drivq 


Update youv MeThiy rodt 1 to im^yde some rusloni puj^t 1 ionLnjt. Nmv wliM happens 
now if we mks putting a value in the price field? 


dow^Jo^d McB^y fi-oiH the 

Head Fr^st Labs wcbsiic ts 
yi all iKcir updjies ， 


WtVc 

铋七 ke same forw 

no errors are 

disipi^Yed- 



N"w when the \ alidator^ run, (lie crmtroller spot^ there 、 a piol>leni with the lbs m 
data and redisplays the form # so the user can correct the problem* The model 
doesii t Sfivr thr jnurd, and th^ ftmtnilleir is now working ron tTily 

Except*.. i$n T t there something missing? 

yot/ are her^ ► 211 































users need coi ： mnr ： ic ； i ： iot\ 


We still need to display error messages! 


It's p>ud ihiU the app r^clisplfiys ihr f< n~m huE then what? 

To fix form problems，a u^er needs to know what went wrong. I hey 
need nrf'j mtssa^ts Mint show fheiTi; 



Which Gelds had a problem 
❹ Exactly Tivfial pi^oblcm^ were 



app 


Every lime one of ilir VBlid^iorsJails^ il stores ail error imsiiagu in \lw 
mod^l. Bui vve want to display thv cnt>r musiigcji in the view. That 
means the messages need to be transferred from the model to the view. 





views 



W Jiicli part oi tlw k liirhlly bum id io a inudi'l ubjcct? 

The form! And ihe Ibrrn tibjecL \m^ a sp^t ied melht>d [h；U vim 
an emir bltM/k, inetliod is caJlt p d error mossag^s ； 




W 

；^d 




new. him! 


<hl>Hew ad</hl> 

<^=， fQr< 〔 dad ，: url 叫 ㈤ 山的心 e , 

% 一 f ^ror_m^ SBages %> 〜，丨 do | 以 ％> 

<P> 制 _ s</fa><br /><% ; f t 

<P><b>l>e S cription</b><br 广 ⑺瓣 %></p> 

<P><b>Pri^</b>< br /x %= f — e t_ area : description %></ p> 

<P><b>S e il er < /b><br /><% 。 f ' ieId ：pric ^ %></p> 
<P><b>E m ail< /b><br /><% ; f ：SSller - id 兔 > 々 P> 

<P><fc>Img url</b>< far 邮山 %>< ， P> 

<p><i - “—it 心咖 ” : im ” ri % >< ， p> 

<% end %> ■ 


ads 
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Tesr Driw 


validating 


The folks at MeBay are now much happier. The validations keep their data clean 
and rhc users can now .see straight away what the problems arc and how t" fix them. 


J j5 j - 


I 


New dd 


Si 

|_ 霧 | 

ill 

■_，| 


This 七 he sirowd 

-to tke f or 

and enrori 3r€ 


Wij 




1 fs lime to release die iww version of tlic cude itj ihe public and sec 
what iliey think about il 


you are ft ere 
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validators quality 


The MePay system is looking pretty sweet 

"Snw ihctl die; ^ysioni is reportiiiy 1 < ri« m^ ccsrrrctl )； llu: loik^ at Me：Hay arc 

mnve ami nn n< j validitinrs, ilic rlird ti>r i\w m'ui s and 

i epi>n^l>ac k any yoblems, Bdin lung i\w data in lire sysu-m has really 

^re;it < [luilily, ^ind ihe m_mbtT ol nws cli'ojvs dnim 彐 linilly. 




Tlu itr s jii^ "sit:- mot^ ihing to do, I hr wilidai^rs ]>rmir any miiji daiii 
hut tb^ mws are nuly displayed when a new ad is poRipd + 

But errors stilt aren’t reported when ads are edited ... 
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validating } n / ] 



This is the code that runs when the "edit" page is submitted 




f update 

@ad 二 Ad.find(paiams[ : 

9ad. __Lpda1-e_atl t ribut es ( 
redirect to 'Vads/ H f 


Rewrite it to respond to errors correctly 


+ p # i »■ 


•r li k i + 


+ + P !i -r -li ■ ri il + 


Write down the name of the file that needs error message display code 


are h^re ► 
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handte editing 



OLutiOrt 


This is the code that runs when the "edit" page is submitted. 


def update 

@ad = Ad,, find (params [: id]) 





Rewrite it to respond to errors correctly. 


dcJf 士 


j@ad ^ hd .fW f]) 


i-f ^idl aitributcif paraiwsC-^dOJ 

m m m, m m m m m m m . J M m m *. ^ K ■钃 •> 矗赢■■钃 I ^ x ^ E . x j. ^ K 


P 4 + «• ■ i # Is ■ ■ ■ + + k 


rtdrcd-t io 'Vadis/^l^ad.idil^ 


■ •§ + + F i ^ -i 


e ° a 4- + f a i ' 


I; »• + * ■ ■ *8 + ■ ■ ■ + !• Is 1 + + P 


+ « 4 4 4 . S 4 •§• > I* fr 4 + + t 釅 


tht 


■!.■■■ ■> Hi , 


>!■，h b p 9 ， •!• c 


+ + .P3++I>|i^ + + 




1 * + |i ■ i»- + f- p B % ■!■ #• F a + ■§■ I- p i I 




end 


■ + -fc i i :; + + b ■ i d* + fe ■ 





Cf\6 


Ay 

P-- 1 J ^ ^ al ' + + a i # + ■ i !§■ + -fc 醒 i ■#■#■* i i A + ft 

reader 


#TrriO- + -l-a^i+#B i ;!• -r r i i -i- >r fe + + >■ ■■+•«• i 0- + -v 


讀 + Is i fl + + M i ■ 


i + ii ■ ri • + % ■圖 i_ 


Write down the name of the file that needs enof message display code 


app/ vic^s/ads/cditht^l e^b 

— ■■ fl Gl ■■■■!_「■■■ Bi _「■■■■_ ■■ 亂 ■_■■__[■■ 亂 1 !T '■■■■_ I 
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vaiidating 



Tools for your Rails Toolbox 


You’ve gpt Chapter 5 under your 
belt 9 and now you f ve added the 
ability to use validators. 


Rails Tools 

^ 3Z Aarat 七的 (iL I i. 

licld m aUhcs ihe rc^a^r e 乎成咖 u L u ^ 

: ^ ldl ^ <tks h0 " 5 

^ - ^ Hat thc ' ，tld 

^ ^ tHc 少鄉 values 

认州一一沪 出卿疗 ⑽ w,tKm aforw 丄 , 

u e ^V C a,a — 仏恤 ： t iWs ⑽』和士 ㈣ … 
^ and ^ ^ a<m t , 

^ dtY 咐 如《 outfui —— 研 ㈣ 

lie^flaie^W erb file 

;>W ^ ^ ^ + ■ 


you are here ► 217 












6 mqkmg connections 





Bringing it all together 




Take a bunch of fine 
ingredien 肀 s, mix them all 

together, and you'll end 
up with something that 
tastes just swell. 


1%%. ^A fv 


Some things are stronger together than apart 

So far youVe had a taste of some of the key Rails ingredients YouVe created 
entire web applications and taken wtiat Rails generates and customized it for 
your needs. But out in the real world, life can be more complex. Read on... it p s 
time to build some multi-functional web pages. Not oniy that, it s time to deal 
with difficult data relationships and take control of your data by writing your 
own custom validators. 
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flying high 


Coconut Airways vmi a booking systew 


Time’s no lx fc [ter way o| traveling between islarntn Lhan by s^LiplaTi^：^ 
and CfK'onul Airun\s lias an enlirt 11 fleet. They t^fTer srenU. lours, 
rXLiusiuiis, aucl a liaiidv sJuiille scrv icc bctv^cen aU ilie lotiil Clauds. 

ji 

[heir service is proving popular with b lurists and locals alike, 

Delmtiid for lireir lli^fils is sky-liigh, and iliey net^d aii online 
resen ation sv^tcni to help tlicm. The system nccch to manage ilight 
and seat bookings* Here's the data they need to store: 





k- 


rttrcVthe 郎 sM ： 丄 


TVs is ]M id ok 

the SCJft 


Remtfnh^r ； wi || 


hcrc s 


Tyi is -tht id 秦、、 
the "Plight 
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T 

nc ba 妙沪 A A 

代 to rded b 


a" 。 峰 & 

P^^ds 


Flight 

id 

integer 

<bI 

departure 

datetime 

arrival 

datetime 

destination 

string 

baggage allowance 

decimal 

capacity 

integer 


Seat 

id 

integer 

flightjd 

integer 

name 

string 

baggage 

decimal 























Sharpen your pencil 


1 ■ Create an app called coco nut? 


a + + 


4 + 


!■•■■■ di 


making 


What are the instructions to: 


4 4 + E 1 HI t i! E » ■ 


4+-F«9S|-+Rl'l- 


-I- I B 4 + + # 


e + + >% # 3 ^> + -p ii i + + > a a 4 . + > i v B i i ， r 


S + + H § 4 4 + ^ e b 4 . + a a i| 4 . # a i 4 , ^ B a d i.. 


g s + + _ 3 ， + . i s • + + i S 4> _ 


■ii # ■ a A p ■ v i r; ii 


a++-P3++Pi 


2. Scaffold the flight data? 


^ T 


kmur^^mmi-riskuu il 


b % + -§• p a 


Scaffold the seat booking data? 


»+++■■ 


4i|>4iP94+«Pii_+P 


•8 r fl i •§ + -r B -i fa i a + r 


B + + ¥ B 


b>. + 唪 S+ + +PS 


B 4 + + r 


i >1 + + > 


ia-T §-!•■ + rdfl+# 


*!• F 


8 d !• B* ii 9- + I- r i i •! r I; B el -r i> i; B -ft ri ri + t I- i i 1 -r fi 1 


t » P I i ■ 


i + Is k B + + 


+ .|i ■ i| i| 


B i il + !• i 


+ P P + + ii 


4. What s the problem with just scaffolding the flight and seat data? 


P fr *!■ * !■ 
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connect your ：^l 


Sharpen your pencil 
l Solution 


What are the instructions to: 


1, Create an app called coconut? 〜 rted ^ 
raiU 

■…… 甲 “ ■ ， ……………”……… 甲 ■■……■■ 以讲相 . w 

2 + Scaffold the ftig ht data? / aj Jdcd 此 tally 

iruby stripVvncratc dcpa | rtuire ： daieii»' c arv-EV^I-datcti^c 

destination allowdn£e : dcDmai iapWi 咏 mie 阶」 ^ J || 

i ■ v ■ ■ ■ «■ ■ ■ i 4> « ■ ■ + + i ■ ■• 4 - ■ ri + *4Jb B el •+ J+ ■ f ■ i + + > ■ ri + -i k ■ i ■§• -Is to ■ ri + -i- ■ ■ ■ ri # + -r f i iri>+l*hrid+4ki++iiHi + iiiB#__riai_iiir. ■ ■ * * j mM # } m i 9 + + H ■ fl il- fe B ■ ;!• + fa 

LlJ^ 

3. Scaffold the seal booking data? . / ^ _ w ’力 

^ |he tafcles/ 

strip-t/ «^raic s^af-Potd se^t <d'integer hawrstn 叫 ba 气 



4. What's the problem with just scaffolding the flight and seat data? 


tKc -fliaHi S€^ft data «ne^stes erne $rt of pdcuc$ w and SrifftKev fov iearts- |i 

■ _ _ ■ ■ ■' m % m m m- w r m m m^k ^ ■■ ■ ■ ， ia v ■ ■ wj^ ■_« 編 ■■ r ■■_■■■■-「_■■ ri — r i ■■# rii ■ ■ 瀾 ■■-•■n ■•■■■_ v ° 画 ■■■— v _■■ it ■-■■■_■■ ■ agjP<«< 腿 ■_»■■■ ■■ 观 ■__，■ t ■ r i _[■■■"■■■■_ in ■■ n> 暹 ■■_ >i 

doesnt dombih^ the 七 wo. 


We need to see flights mi seat 
bookings together 

II wc simpJy create sea (Ibid ing mid don 1 1 tusUmiizr iUl- app, il will hv 
hard to use. In order to book a seat on a flight, the user will have to 



We need to display a flight together with its seat bookings. 
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fTIBking ?r. : r 


Lefs look at what the seat 
scaffolding gives us 



I/[’ s sec how ihh rompares \vUh Lhe 叱 iU p 叫門 

gentrraLed by Uie sCtifToldiitjp 



Can any of these help us generate the flight page? 


you are here 私 
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combine 


We need the booking form and seat list 
oh the flight page 

Two ol the generated pages look pretty similar ro what we need on (lie 
Hight page r she seat \hi and the booking form. The middle section of 
tlu 1 pa^e Irsoks like the seat Ikt, arid the hooking form looks iikt , 

iliv mtl section ： 







« ^ ^ 


LJstlng uals 


m：D 


TKe icit list 
look& like "thff 

heirCe, 


也 ■ L:l^. 


fll 


■ ° 


A 


•hbrp JJlOGtffumt iDW.'MHi-in-ii- 


■W 如⑽ SM 

looks liWc 

iht t^yd setW ^ 


(ndex.htmlerb 


now.htitil^rb 


rilM 








1LC 


V M 




u mm 




I « 


ul hr 






P-P _ 


MKVP | r l l 






seats 


app 


views 


u flights 


show.html.erta 


So wc need rhe lliglii “gliDW” page to include v iew code 
like the ?eal “index” list and the new seat booking form- 

So should we just copy the code from 
each form into the flight page? 
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making 


BCttO 


a 





Mark 






for 
seat And 
list pa^-ts 
the fA^c 


OK - so weVe got to copy the f orm and 
the seot list cods into the page template. 



Mark: Woah - vvait a mliiu 【 e. How iiiiidi code h that? 

Laura: I dun no. Wc need the code in the! page, though, it’s in the 
design. 

Murk: 1 kjwvv vvx' need the seat Ihi and thi- hooking Jorm tu dppim 
in the page, Bm docs lhai i neon we have to have ilic code m ihcrc? 

Laura: Why - wluit’s ll w probJem vvill \ ihaL lol]*. 1 ? 

Mark: 7 bt* se^il lisl and ihe booking finm are doing siijr-n jfiramly 
difFereTil Ltungs. Csni l \\-v break tliem Ltparl suniehc^v: 1 

Bob: Brrak a pan： 1 Voti mean i ri lo sppanile files? 

Mark: That way we could ha\ e one iUe thai displays a list o! 

s^ats f one that dkpiays the hooking, and ihen include or call each 
pa^if from llie main page, 

Laura ： Oil - like separation of i^onrerns. 

Bob: Whafsi lhat? 

Lriura: Sepciralion of concerns. It nicaiis you get one piece ul 
codv to do just one thing, Makes it easier \o track down bugs- 

Bob; Sure, sounds … buL how do you iictually do ihni! 


m/Mi 


flow can we spilt a page's content 
up mio separate files? 

If w'f ： can split n page into separate files, it wilt niiike tilings 
more manageable, Bm liow do we do that? 

Raik hu us ^lorv frii^meut& oi pages into scpaiait files tLiilod 
partial page templates in — more simply -partials, A 

pai tiaI is like a isvib-rourine that ouiput^ a small part of a page. 
In our case we can use two partialsi one for the »eat list and 
another io urfd a new seat l>ooking. 

Piiilials are siriijjly fin Lidded Ruby lUcs，Just Jikt 1 temp litter 
The only differciict is that, unlike templates, paidab have 
names that hemn with ail unckrscorc ( :, 

BJ \ JT 


you are here ► 
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embedded 



) Fil^ Up Cl^e 


Ut now have three kinds oi I ,nibedded Ruby : ERbl ftk: templates, layouts. 
aiKi par Hals, But wliat's rhe rl ill ere nee betwm 】 the rliree, mid how does each 
lype nf F.Rb f\i in witli the other types? 

\bu can as^cnible a web page with ERb files in the &iiine way that you cl \m? a 
pile of in gradient s to Kemble a burger* 





A 一户如 古。 u 

矽叫 h a st^dard W 

\C A 仫叫 btc ?T^_des 

"the maim 

'TU ?* 如 4 杯 e V , kc 伽 

a^a 

^ 研狀 ate 叫巧 _ 士』 


layouts 


A layout gives a set of web pages a Cfjnsisieiil look ， 
mostly by providing standard pieces ol H I ML tlini 
:it ihf 1 tt)p and l^nilnm ol pat h pi-igs, kinrl of Ikd bun 
wrapping a hurj^tT. Ry dtHliull, al] Llie papes assorialed 
vvi[li n giwii ioiiirollL'r will whiire \liv sitnie tctyouL 


Templates 


A template h the main ronleni «>l the wd) page, like 
ihe nUin.^ in the burgee A template is assortu+ r d vvilh an 
a.c Lion. So Llierr's ci “: ■mpktLe U> show ilw iliErhl dt 3 tails ， 
and anotller for iIil_ “JSt-'s lliirhf form. 

Partials 

A template might call separate pariiah to build a page's 
main rrjnlent, Rirthils : ire like the ^ub-in^eclierns nf 
a ]ikt T the Lorn a La or llie lt fc LUKX\ Parliak itlhns 

you to break up a complex tumplatr intu smaller parts. 
They also allow you io separate out common ran tent, 
like menus and tia\ igariou bars. PanialB can bf used by 
template r, but also by layout 、 
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making connBctions 


A bunch of ERb files, in full costume, are playing a party game. 
'Who am I?" Theyll give you a clue — you try to guess who ttiey 
are based on what they say Assume they always tel! the truth 
about themselves. Fill in the blanks to the right to identify the 
attendees. 

Tonight s attendees: 

Any of the charming types of ERb files you've seen so far 
just might show up] 


^ho 


l? 



Type of ERb File 

\ contarn the navigation menu. 

I inciude the title that appears in the browser window. _ 

1 display a form if someone needs to create a new object. 

I display a contact email and a copyright message. _ 

I give a set of pages a standard looking navigation bar 


It 
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meer your 


A ^unch of ERb ftles, in full costume, are playing a party game, 
"Who am i?" They'll give you a clue —you try to guess who they 
are based on what they say. Assume they always tei! the truth 
about themselves. Fill in the blanks to the right to identify the 
attendees, 

Tcnight’s attendees: 

Any of the charming types of ERb files you've seen so far 
just might show upl 





This h a paje tw\d be 

used pUtti- 


I contain ltie navigation menu, 

T^at viWk HTML <iitlc/> 
tis hflndled by ^ 

I include the title that appears in the browser window. 

Arc 议 d with individt^i like 

i disp)ay a form if someone needs to create a new object. 




on Wli' 


TKis is a partial ii J $ a but Ht 初 ill probably 

be tiW^d by a layout 

1 display a contact email and a copyright message,. 


Type of ERb File 




layouj 


icmplaric 




I give e set of pages a standard looking navigation bar. 

A 卞:七 eon^hrob iUc look of several pays, it Mil 

probably ta\\ ihe 此 on bar m a septate partial 


layorh 
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making : » nr :iorf 


ERb will ASSEMgiE our pages 

\Ye iitftrci tu crcidt ptu ticib Ibr the ljoi>kiuji; form and die st'iil list, 
antJ then limbed (led R.uhy can |)r(jce^ tlu ： Jlight pagt ? and call ihc ^ 
paiiiii k cadi time tlic rendei expression h reachecL 


^ T>us allots d seyjrdiiw L t - e ^?" S 
w« Ka 代 stearate ㈣ 七 dcah W 

Wki 叫 >d st 也 ^ 

晰山 a 代 to^d W 
user when hCcdtd« 


邱 b 』 assemble fli^t fage 

cut the itr.y\S^ *ow^kt«l. 
erb, bootiiv^ Wf" 

a^d iV>c seat 1^ partial 




lo Do 


口 Ct^atea book/Ng for^ part/ai 

□ Add the booK^g forM to the pag^ 

口〔戊她彐知 t 晚 pgrtfal 


□ Add the Seat !/Stto 


ttepage 



flighta/3 


ftlghts/2 


When RaUs gets a i^quesi for flight inibrmatioii, it wiJJ 
use the partials, re nip] a and layniii with Embedded 
Ruliy Lo generate a single HTML response^ 

Lct'& 讲 an by looking at the first thing on the ]kt — the 
booking form. 



fUghts/4 flights/5 nightsm flights/7 



fllghts/8 



229 




















partials are just ERh 


So how do we create the booking 
form partial? 

IWLitth lire \iisi am ^ihvr tdnd oi ERb [\k\ so they L-oiiLiin ilw same kinds of 

ih?x templates con ram. Here's the conteiH of out _new_seat, html _erb 
partial It coimdns exactly tlie same ax\c a^> thr new sraipage, which meam that 
all we have io do h copy app/views / seats/new .html ,erb and .save it 
app/views/ f 1 ights/_new_seat, html, erb: 


<hl>New 

<% form_£ort^seat) do |£l 

<%— f a eirror^messag^^ 

<p> 

<%; f,label : flight—id ^ ><br 
<%= f.text_field : Uightjd %> 

</p> 

<P^ . 


<%= 

f _■ 

<%— 

f 

</p> 


<p> 


<%— 

f. 

<%= 

f. 

</p> 


<p> 


<%- 

■ f 

</p> 


<% end 

%> 




%> 




■h 


L'.j l n 

Jt f - - ^ ^ 




flights 


new s 旮 at.htmf. 旮 rb 


seats 



fiew.htmLerb 


Jo fircatc the farbali ^ 

研 /v,tW 邮狀 b Yt 

new scathWcrb It 

私 e frt^ wakes ^ P 3 ^ 81, 


M/c need to remote 'this 
li^k to 'the !i^t jlL 

ieais Wt do/t n«d this 


\\r could have le ft the partial in the “scats” folder, but 
ne move it m\o the "Mights ' folder lo make it ^liglitly 
ea^k'r to ral], Its aho really important ihat the partial 
begins wilh the ^ rharacler, TIip character b used by 
RmLs Lo Jistiiiguish partial iVom pime IfinplaLeS, 
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making 



Now we need to melude the 
partial in the template 


Crtudnp die piu'dal Ls only Jmlf tlit* j(^b. iu>\\ lu'i- d l<j modify the llinhl 

shuw.htr.iLcrb pay：r template to include the partial in its ouipiu. Partidk. like 
tcmpkticH, arc reaU) jurii pieces of Ruby code disguised to look like H IML, 
And in the same way xhm one piece oi kuhy code can call anmher, i]w 
template can casiJv caff the partiaL 

So how do you mil a partial? By adding a render command Ui the flight 


page: 


<b>Departure : </^> 

<%^h ^flight.departure -■> 

</p> 

<p> 

<% & h @flight^arrival 
</p> 


叩 P 



views 


一 > [3 _ hts 



show.html.erb 


<p> 


<b>Destination ： </b> 

@flight,destination %> 


<p> 


<b>Eaggage allowance ： </b> 

<%;h @fligtit.baggage_allow^nce %> 


</p> 

cp> 


partial 


<b>CapacltY-</b> 

<%^h 0flight,capacity $> 广 

</p> ^ 

< % = render : partial^-new^seat'' %> 」 

<%= unk co _Edit,, edit_flight^p a th(@ 

<%; link to 


Back 、 £lights_pai:h 



You don’t use the 
exact file name 
in the render call. 


Watch it! 


Even though partials 
begin with _ and 
end with htmierb, both of these 
should be omitted when you call a 
partial with render 


The iviidcr call icil EmbL-dckd Ruby to !)ruc ■: ss tlie piiilial and hidudc its 
output at that point in the file. 


The partial should now appear in the flight page. 


von are hBfe 
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render in action 



[xTh Itjok at du? show - httifcl * erb pa^i 1 :ind rherk Oiai (Jit* booking 
Ibnri is appearing correi tJy. h ■ enter a Fl_w [lighls into the sysLcin and 
then lixik at the first by going io: 

http : //localhost;3000/flights/1 



A strange error has occurred* The flight page mas working 
bejhre me inserted the partial ； so mhat went wrong? 
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making connoctions 





Looking at the errors generated in the test drive and the code from the partial, can 
you figure out what caused the crash? 


<hl>^ew seat</hl> 

<% form_for (@seat) do \^] ^ 

f . error^inessag^s %> 


<P> 


app 


<% . f, label : flighted %><br /> 

<%= f.text^Eield : flighted %> 


</p> 

<p> 

<%= 

<%= 

</p> 

<p> 

<%= 

<%= 

</p> 



VI 0 W 3 


□ flights 


f.label : name %><br /> 

f.text_field : 議 e 





new ^eathtfnl.erb 



f.label : baggage ^><br /> 
f _text field : baggage %> 


<p> 


<%- f.submit "Create ◊ 


</p> 
<% end 


you are here ► 
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partials need 


We need to give the partial a seat! 

Hit 1 proljlt'in is tJLiUw^d lht a ERb t ode roiilaiiiii a reEereiitx tu 

the @seat variable. So why is this a prtjblcm? 

This lilt 1 used li.i hv ci pi\^e lernpkdt 1 willt ihv ScitbC(mLrollfi: 

T 1 10 SeaisC-oiitroilcr inidittizcd Hw @seat instance V LiriabJc like Lhb: 

@se^t — Seat. new 

Km \w*w rhr fifr ik e -is I m mu，a p/it ii.il iluii i、f imi; ii ■ f 『 i im < I 1dtr 1 
Fli^lusCniun and LhaL conLroller Ikls no t insianr^ vitriable. 

So u 七 tired lo dmiige @£seat iriUi a k，LaJ variidjle called seat: 




^hl>Kew seat</^l > 

<% f_ 一 £or(@seat) do \ ^ 


The wobkm ^ 

加 rt^txtU€ ^ seat 


variable 


(ns^ejid ~New seat</hij 

^dridblcj j <% fo ^for( Sea 

ddh use tJhc locaf J <%= 


V 


liable ^ccit ihstead 


f-error 


t) do if 


%> 


<p> 

<%; 

<%= 

</p> 

<D> 


一 JTiessages %> 




/> 


%> 


<% ^ H%> <br 

</p> - Id .娜 

<p> 

: f / lAbel :b ^ag e %>< br /> 

♦ _ ^' te ^ aeld 如啡 ge 衫 


<P> 


< 


</p> 

<% ^nd %> 


f ' sub ^it -Create^ 


%> 





flights 


new seathtmLerb 


seat is called a local variable bt-cause nothing outside the partial 
(.■an rt-eid or u-riit 3 lo iL. But if £haL^s tlie case, llwn henv do wv pa^s 
ihi^ parlial ii valuu ior ihv seat. variiAblf? 
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making connections 


You can pass local variables to a partial 


Piirlials mid lempliik.s w urk u lot likr Kul)\ mrlliotls m (1111^lions. When 
a. tcmpJiitc reudL rs ii tial ， It's a little Hkc one function calling anritlicr 
tiiticiiai]. 

And siiKr ,■ | '；is ii,i[^ like a function, you can pa^s inpar^i.meters like this: 




\/jW^ 


办 c ^ 


汾 t 






is a ^ 
.ariaWes ^ ^ 


A 


<%— render : partial=> M new_seat TI r : locals=>{ : seat=> 

Wl wiUhe r - ^ 

-咖一四 tH, erb p ㈣ ■ 


%> 


\ 


\ot^ ^ w 
s l : A T n 

X 




I1]r rendtT mclhotl r[i]i afrt'pi u luisli fiillrd Iocal f: + W 11 Imi Lht k haslh you 
inn irlc/lude a set of values intli a xt k d hy ii \ driiilile ii.ini^ L\ke ]H _ euy iiiLtdi 
(^tTV Ul loro in KluI^, iia]m m\: cxpressml as symbol. 

But wIimL \ iihi* fc ■sh"uli：l we jiiii^s 111 liir saa t? LrTs look ai ulu“ v^Im 1 lt!t. 

urijfijLil S^iit^C'niiLioIltT used: 

def new 


@seat 


Seat * new 


Because 1 hr l^rm is being used to inhialbe a seat, we just need to pass the 
Ibrni a irrshK' rmiled Sea l" "bjt.rn 


io 


C 二卜 ㈣ 
€ 


<%= render rpaitial^^new seat 1 % ; locals=>l : seat=>Seat .new 丨 %> 


So has this fixed the problem with the flight page? 


t^sreiare m 

Dumb QuestiP 


ns 


Qj Do I have to make the partial use a local variable? 


o 


Why? 


No. Parttals can see all the same instance variables (the 

yartabJes Degin；ning with @) that page templates can see But it Is 
good practice to use local variables in parties. 


It makes the partial less dependent upon other code. Page 
templates are intimately dependent upon the controller, so it's OK 
for them to look at controller Instance variables. But partials are not 
so closely tied to coilrallers, Many applications use shared parliais. 
wiiicti are partiafs used by mor^ than one control ter. If partial only 
use local variables, you will find them easier to manage 
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render 




Tqst Driws 


a on 


With the scat object correctly initialized, the |>r<：\doiis cras.li slvmld lx 
avoided Let'^ try refreshing a flight page; 

L 栌 igtirs ttww 

^ _ ^ 1^ £1 — -." A t " - • I, . * L .■一 

>,k7/ t iwiJiwtt lotrt t J ti B h^i 



0trsat^a booking for^ partial 

the booWt^ fom to the page 

□ o^ate a 安 at 脫 partial 

□ Add Seat Et to the page 


, L^ t ^ «r^ers 
TKis I a lotal 

: 二1 …。 —— 
Wftw 叶辦 
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<%" 


making 



I don't get it r I m on the page for 
flight number 3, and I hove to write 
the flight number into the form. But 
surely ths system knows whet flight I 
mean - it s on the page! 


We can pass in the flight id number 
to the booking form partial. 

Rul hou will Un a form List 1 Lhe id? And how 
can a form pirwitk a delkult value for a field, 

without Ehe user? 


lke ^ ?l a n - 一 

m # a ^ ； l- 


■: u 



To Do 

0"treate a booki^ partial 

□ Add the bod ^ 崎 fom to the page 

□ Created Seat liSt partial 

□ Add the 赋脫 to 伽 page 




Sharpen your pencil 


% 


You c^n specify the flight number when you create the Seat object. Add 
the code you need rn the f lights/show , html . erbfile: 


render : partial=> rr new seat ”， :locals=>{ : seat=>Eeat,new( ) } %> 
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defauh 


^arp^n your pencil 

Solution 


You can specify the flight number when you create the Seat object. 

Add: the code you need in the fl i ghts/shi 3W, ■ Li.m]rb file: 

Thi^ is 

a fomi ^ 


<%— render : partial-> ，n new seat 


\U 



THs dodf is. Irovh 
叶 p/vie ws/fs^.htihUrb. 


locals— : seat—>Seat * new 


n 右吵 i」 d 
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making connBctions 


P 触 1 Puzzje 



shouldn't have to enter a flight 
number, so we need to store the 
flight number with a hidden field. 

Can you assembie the pieces of 
code to do that? 

<hl>New sea.t</hl> 

<% form for(seat) do IfI %> 
<%= f-error messages %> 




TKc toAc ^ hidden . 

i\c\d kfi 5° 岭七 <P> 


<%= f. 1 abol : n cijna % ><br /> 
<%二 f. text field mams %> 


</p> 

<p> 

<%= f.label : baggage %><br /> 
<%- f . text_f ield. : baggage %> 

</p> 

<p> 

<%= f - submit "Create" %> 


</p> 

<% end %> 


' 


Note: each thing from 
the pool can only be 
used once - and you 
might r>ot need aij of 
them! 


nvs is ^ … 

研 /vi t W 你 w - se 





you are here ► 
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Puzz]e 心 Jut^n 

We no longer need to enter the ftight 
number so we need to store the 
flight number with a hidden field. 

Can you assemble the pieces of 
code to do that? 


<hl>New seat</hl> 

<% form for (seat) do | i\ %> 
<%= f.«error messages %> 


end >1^-fVeld ^ ^7 


n " c 此 c k}^ has iht A 吵士 

d so d 读/士 to paw li ih. 


£ + hidden field 


id 


I ■ ■ ri< + + i i • 


<%= f , I a,be I : iianip %><bf /> 


<%= f.t0xt_fi^Id : name %> 

</p> 

<p> 

<%= f,label ;baggage %><br /> 

<%— f,tsxtfield : baggage %> 

</p> 

<p> 

<%= f. submi t ’ r Create TI %> 


</p> 

<% end %> 


X 

1 二 一 icat 似 
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mBking cq/j 




Tesr Driw@ 


Now when vve gt> lo a llight page, llie High I nunibrr lield Ims c I i^ap] neared 
{torn the form... ]u^i like we wajittrti. 




o ^ ^ 


c 


MLp 


W#J 


ArHiVil - 於 抽乂卜 ’ 1 1 
W 。」■九 

■.B ㈣ 4 ■ 物 帥 … 

邮 “’ 

New seat 

二一 


tip 


gtd 




Thc ^ W 土叫 

\a& mtktd ta ? ^ 


__ _ ^->-=^=^^T~ ~ 


The form works! 

I he [light number is now axuomattcally picked up 
from llie tliglit object. So whai s next? 


"To Do 

0treate a boo^^ for^ p^r^al 

RAiJ the boofeg forM to the page 

□ Create a《eat 晚 part 湖 今 _ 

□叫 d the ^eat \at to the page 



wc heed kp totate a S«t H 


you are here ， 
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partials start n [ 


We also need a partial for the seat list 

Wi* caji romtrrt: thf st'iU “iiixiex” list in, inure nv less (Jit: !^iiiK h wav that 

|T 

wc converted die booking fbrm — by copying ihv original scat template 
file to a partial iile. Lei’s call this new partial seat list. html: 


the f I e ^ ateve ,{ ^ 

tabic KeMihjs a h rf the tit- 


?■ for seat in ^geat^ '^> 





.d 


ypu lt need rchanis the 瘦 seJrU 
ih^ar^ variable ts? stats. 

Vcki dotk^ t\cc& to 

ttyUu^j-Lx ~ 一 —「 disfl^Y tVie 

seat .name %></td> id as 1 七、 

<td><% 吨 s ^at.baggage %></td> 如 %>^乎 

_ 1 *： U i-ry 1 show 1 f 》 x/td’ 

Xin^to • Edit % edit^se ， tj ， athtsea. 

<_ u^t 0 ，喊 o, r; f 二二 

yOU SU^e?，， ：meth ° d 

</tr> pajc feeda 说 

:% end %> \L~ 


k 1 lu 1 ^ 


Put the seat-list partial needs m array of seats 

The seals "index" pa^c diiiphiycd ihe cunLcritsi of ti SeatsCoiitrolltr 
iastance variable called @seats. The ScatsControEer created the 
instance variable just prior to index, html • erb was displayed, Bui 
'vhai about now? \\t copied the index .htm 丄 ，erb template to a 
paiiiaI (lirit will hr di^playrd Lift(T mmiitiq; the rii^hisCimiiotler^ so 
LluTe 1 ^ nu @ Ls instance vairnb!^ toiit^inhig an arniy of seals, 

■That iiK^ms we need tn provide ihe new _seat_l ist, html *erb 
paiLktl with kin rin ay of So wbal v;ilu^ should we j3ir?\T：tle for lb^ 

aoray uf seats? This is how the SeatsControUer initialised Us sat a: 
def index 

@seats = Seat*find £ : all) 


So, for now; let's call the seat list like this and see how it works: 


app 



views 


flights 



seat (ist.html.erb 


U[ 


seats 


1 



(ndexhtml.erb 


/ 

f 

fci dre^tc tKc wbaL 


sc3ft 


I I 

ht^ 


save 

e^ri 



We II add ^ ^ ll ^ 
a —eW 总吵 b AWw W W c A 


wtll f3^ this 的 value 



<%= render : partial=> ,p seat list,『,r locals=> { : seats=>Seat, find ( : all) } S> 




鋪 tWis «ork? Ut s sec 


242 


Chap ref 6 


























making connBctions 




TesT Dri 赃 


Make all the^c chaiigt s, add llic new pariial, and iry ilic app out 


fi\\ ^ tiw fay 

3^ 


TKis 〆 必 

* aatWW 


ytf^ 

pirb 3l 



^mmmz » 




¥» 




■!•-■ Mf 


tv>d b- 



iTAtti 


ifir-i 



New seat 

l llflHHj 


膽 h :， 


DQ VIC 


Ef#KJE|P fj 

Listing seats 


TMs f^ri 

gewraied ty the 

JWiJisUW 饮 b 

pai4ial 


tiiif |JL9 


%U _ .1 <^1 p 

ip$ E^jeiai 1 

kf Ifj. j{ 

t^*am 

£ir 貧 



•B; 9w^im 

t 

Pm 

lA? / 

It 3 

3£||B 

%QEK=Hr ~ - 7 


Id: DsHob 
tea Ml M^Etts 
奴， 幽 Siam； 
E^jt^rr 


To Do 

gtreat^ Q booHi^ ? orM P ar *^ 
0^Addthe boc^i^ ^ ortA to 

^Create a Seat Wit P art ^ 

Q^Add t\ie Seat & to t\ie page 


TUv Jbrm hoks like it's \\nrkin^. Lei 5 s see whai the users think. 


you are ftere ► 
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iepers, 


People are ending up on the wrong flights 

Evt'ryoiit- lllinks the syslcrn J<Kjks ga t'iM. so 11te sysU.ni yot fc s I5\e, 
Ufilbrvunatdy; it dot an"t takes long before soim^oiu ： spsjt^ a pit>bkni... 


So what happened? 

T!ir lligli l page is tli^pkiyiiijr all lht s sral but^kin^s Ihr all die 



Dude... I booked a flight to c beach 
party but wound up on a hisTorical 
foitr of an old leper colonyS 







Listing seats 


T^se Arc 

不％ M: pages. 



EaA fli# or. 

IS sViowih^ 

sLt set Wki 呼 


So whiJl、^ung tsfiL J 「lie jjrohlem is taLtsL'cl by llw render romrmmti 
vv!iidi iiitk thv acat list partiai. RjtmL-nibct, wr calif d die partial like this: 

<%= rend^r ;partial=> T, .3^at_list ,r f 

: locals->{ : seats->Seat, £ind{:all)} %> 




FJii^i disjjlti) s tin 1 liaL of all m ilit 1 dtiUibcist.\ Iliat. vvius fine when 
die seat list was ihe index page (or the seat data... but n(_w that wc'rc 
displayijig the data against the UighL vve nt ocl u * restrirt the seats ^ > that 
onJy s^ars belonging to the currenl llight are displayed. 

We could lix the lindci".. but it would be better to create a relationship 


Chapter 6 
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making 


or 


A relationship connects models together 


Mmll oRrn iiml 1!ihI t crluin modrl ohjri Is m v fillni list'd In^vllu 1 ]； like 
i lights and seal hookings. Y"u sniiy m；rd it sc tlata in mi rsm. t\pc — 
like the flight id — to find ihv ivliUrd objects in ihc other type, like ilie 
seats houkfil on the flight. 


\L.m could \iM usr iindo^ io n wd liar ( 士小 n 1W rxamplr^ il 

you had d flight nbjdl rallrd @f light, vejii c«>ulr] lind the seat 

nhjects like this ： 

RdhutlnS 

.itr 

Seat * find all by flight id(@flight * id) 


seat objttts 


But h、iH Uhilly In connect sht h (w" midd tugrihci 
with a relationship: 



A relLilii>n^hip iikiIujs nl>jct ! Ls of "m_ Lyp( h (A ol i\viA ,i] jjjt'jr to 
be dttrilmtfs uf ai^ j llier lype oJ:' ob ject . lw cx^]Li|>k\ a I wo err ati L c\ 

thr lligh* in"ilrl \\vm r"rm[:ciM tu thr s-cmi nuxk^l, wr 
ran rdh I 。 ilw Rdts assoc btfd with a (light likr thb; 


Thtic now temuied at 
thc :咖 Id _ 

rf' d handle 

thls 此 Ohihip ROW, 


@f 1 i -ji lL. seats 


This wilJ n-Nirn i\w nu i lhini( the finder ^ibo\ ： t% bus rlf b lining 
a relationship helvveen iwo mocld will simplify \>>iir vuclc luhI ivdu - 「 
[]\i' rliimm llii.il ys m ^ ill umkm inisiakr 1?\ rtqjrLil^dly tlrfintiig 
i’iiidm io jump !h：im one imxld i" antitlier. It will also make ymir codi 
a lot easier to read. 

Sounds good. So How do relationships work? 


you are ft 伫 re 


K 
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relationships took 



护 Cl^se 


A iclaLitJn^hip will join \hv data iii [hv 叱 iU : mci flight Uibk^ 
by marching the data m (he seat. f l±ght_id and 
flight* id columns: 



Names are 

IMPORTANT 


ill Rails. 


seat,iliglit_i J " 2 
matekes lliglit.icl 



CAarLiv ColliRw 


龙 OOi-ll-ll lit 
猶 f-il-U 1 


jooomi 3 2 

?DOB-ll-l] 
20M-U^U 12 


joos-u-n i2 


tor the relationship to work ? the field in tlic seats tabic _^ } 

mu^t be called f light_id. and thv field must be an integer ， ^ ~^ ^ 5 iKc 相 aUhmg 

.„ ~ , , , ld in -ffkh-b igblt 

W ith a relationship iii place, it means diat wlien Rails scey this: don^c^t 'th 


@ f 1 i qh t3,3g£ltS ^r 


It will tieaf \\ like ihm 


T>iis loob like an ^HriWbi 

but rt_s «atlY s «tat ⑽ H 

two taWes —-J 


Seat,find all for flight id(@flight.id) 
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making connBctions 


Put how do we define the relationship? 

Wn Liii ! poiiiy ki dir [Hiyljl liindei :lii vKXux iULrilulk. cuJlrt! 
so it niiitesi sense that the Flight nuxlol code k iho place where we 
deline die relationship; 



class Flight < ActiveRecord :: Base 

has 一 many : seats is ^ 

end ft—t W 

II ie has many command accepts lilt 1 iiiinitf of £i n^atL'd modf l and, 
l^rcanse it will hv used to find arravs of reliitul die iiiiinc of tilt.' 
nnxki is plural So the |iaramctoi' for has_many is : seats and 
not : seat (without the ‘V’ at tfi€ end} + ()nce the rdattondiip is In 
jilare% yru ran iisr ymir new attrihiUe like this; 





ll 


flight.rb 


@flight,seats 



11 ir seats tribute returns an array of seat objects a^sociat 

wiili the 






Sharpen your pencil 


Rewrite this line in the app/views / [ lights/show *html 
template to use your new relationship: 


<%» render : partial®> ir seat list”, : locals^X 


■ 01 b 

} %> 


you are here ► 
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test 


r %ihdrpen your pencil 

i Solution 


Rewrite this line in the app/views / f 1 i gh 15/h tm 1 ,erb 
template to use your new relationship: 


<%= render : partial=> T ， seat_list r, : local s=>{ i seats=> %> 



Test DriW 


Muki ： all these changes, and rdtjad! Tlvc flighi pages now s.>idy show the 
seats allocated to the giveti flight, So when we look at flights number 1 ^nd 
mini her 3, rhev now h^w difleiTnc seal \h\s: 


A rs n s m » 一 

li ^ mu jymKilFiffW tsfa- 


RvgAti hliM 


ia oq yr 


PAp^cturvi iii* I 

4ft*v 春 U i'DOf-1E-1) 13 ivotin' 

I--WMtg#« - h 

i; h <0« tfinrtnciiii >E> 0 
Cfiwctty ； ii 

Listing seats 


]ATPi__ 

Gkaffitwi 1 ttrijiBnt 

T_d 

l#11v 

J-ii£k Cjvunjf 


New seat 


Hmmm 

llPd 

iS-d 

a 咐 《§« 

ftbDM 

Edit t*»i£n - ^ 

EUlUt O^i^irr 

ia.9 

裂 hoi^ 


It Q 

Sbu^ 

Cd'l ps^^9v 

^)9 


fM Owroi 1 

14.0 

ttmc 


ll 霸 

msem 


jji d 


E£lLt ； [㈣ ITCfl 


IL^h 垆 


LSh 




plight 1 


ka 叱 dsflc«tii stats 


V___^ 
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making 


Put some people have too much baggage 

N(>\ 、 ihm’s a prolilfiii uilli <m Ll w fliyiits. Soiiil * 1 pi’upJe 

are arr iving; at ihc airport carrying too much stuff~way more than tliu 
all^iwance lor their lligiit. I he llight data records the maximum baggage 
allowance, but a lot of the passen^er^ lire unliapp) because they told 
ihv airline how miK h baggage ihey were b 1111^111 g with (h^m when they 
tillered I he seat fx ioking, ^11 id the system didn'l tompldin, 1 he sys【em 
neeib Uj Ije modified la pj eveiU. penpk* rurviny 此 ith wills ioo miu li 
baggage... Ijcfbre xhiy show up wiih a booked scat. 





fj ■ ^nliMiir )DH) 


D*pMitUI»! iww U l l t) 加 QC 







CbL 




- ^Sharpen your pencil 



We check data in Rails with a vaI dator. Which of the following 
validators do you think you should use to stop people reserving 
seats with too much baggage? 

□ Nonen We’ll have to write our own, 

I I validates 」 ength_of 

I [ va! i date s _format _of 

I I Halidates_uniquerHess_of 

I I validates intlusion of 
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write your 


^rfwi your pentil 
k Solution 


We check data in Rails with a validator. Which of the following 
validators do you think we should use to stop people reserving 
seats with too much baggage? 

(vf^None, We'll have to write our own, 

I I validates,length^of 
□ val idate s_form at_of 
I 1 va1idates_unlqyerie^s_of 

[I validates inclusion of 


We weed to write our OWN validation 

ivitli a set ul in Lilt-in that can peili_rin a lot s]l 

i>nsir it^r、like whether data h enteird ur il' 1 e is, mt nvtly Inrmmied，But 
soni^tirties you will need lo chfi k something that isn’t rrnuecl hy the 
Insit. mlidalun 

In thr case oi baggiHgt、Riiils rume wkli a 

va 丄 idates 一 too_ much_ba qg age valkhitnr, Thcnf 、 na( a 
inyxinuiiii value ^lidaior, drher. we need to write mu own 
% r a]ichitw 

II you i rcate a metliod hi the Scat code railed validate, that 

¥ - - < ^ 

mrilind 1 11 ahvays ix k r ； Ll1t j d \w <lie siiofld iilijcri jusE bf-fhn' 
lliinjpi siiYvd nr LipcIaLecl ia Llu^ 

class Seat < ActiveRecord: : Base 

de£ validate < - - — 

if nam^ == flight—id 

errors ■ add 」 to 一 base ( M Your name is the same as your flight nuinber M J 

end 

end 

end 

Hit 1 &rioi s add to base (_ . *) coimtiaiul liistTis a niessci^c. 1 
iiit“ ihr ikt oi erroni. It ihi/te H an error rm^sagv ciCfitcd, tlic save u] 
updatr r priatiun is ;ibniie<S vmd the mci siiould be srnt back ihv 
form to corrcci ihf' prohlt-nu 


^ CI ^ ，JS ^iher where 
in h tcally 

i-pgrtant By usinj a fa^iti 

^ - ^daU t Rak k_s 
ia do your method. 
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making connections 



Write a custom validator to check that a flight booking has baggage under the timEt for the flight 




i44- + + -«4fl + l-B4-l + P14-l + 


■ ++1>819>峥 + 


1 a n ■■ i i a 


9 ir v ■ ■ i 1 ■!; r fa ■ ■ r -i ■ ■ i 1 rr ■ 










■a 



IL .li 




n 


■ 


you are hBfB ► 
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finder? 



ExeitaSe 

SoLutioii 


Write a custom validator to check that a flight booking has baggage under the limit for the flight 


vdlidati 


Find ikt allowance (rom the 

dass £est < totd :: Basc 本 1 緘 Wi ob\«t Va* w n read flijjbt 

/ objrit 山巧 a W 如 id 

.■■ tt _ ! 鬱 ■ n v t ■■ r ir '■.:■■■ ;r ai r ■■ n n h ■ fi : *r ■ ■ ■ ;r t ■ p ■ prt 1 b ■!■! i t rii ■ v n - ■ n d n ah *r r ■■■■ t r ■■ f ■■ ii 

it baA^a^e > findf+l^ht id) 

H B 4 手 + F S， ， + h K V-V ■ MP >9- -9 4 + •¥ F f 4 -flj- ■ i 屮 + 寺 ， 4 4 + + P 4 4 IkA ， + _ ■■ + + ， ■ ， -hP 9 4 ■ -P 4 + g ^ 4 a + + >p S 4 + -8 1 P 4 fl + f B S + # P 5- + F F S< 4* + !• B ^ 

£H-crtrs.add_t? bas^T 丫 esu hav^ too mudh ^ 35 ^ 3 ^^ 
end 

PBs , r c rBii9 i Baaan <■■■■■■ m ■■ wt^iVTEsi 1 ! 11 !* ■■4 tt ■ 罾鬵■罾 罱 _ ia rrR_tr '■■■i a r i rF^ > ii i « i B9 ， i :> rE < vTri!Bnr_r i rFriT i rp^B ’_■■■■. 

end 


e^d 


^ i 1 



We re using a f inder 
to look up the flight 
abject from the seat 


Prefer relationships over m 為 nuaf finders. 

[nshMiJ \A using lindei s. xo l"ok up tlic related (light object^ you 
can ddim、i relationship hr 1 ween and Higlitfi, But tlie 

qu^slitsiii is, wbat son ol ivljlhmship da u.e need: 1 

When uy 1 t/rcatt-rl a rehuionsliip bt line, we iht ： l.'[ighi m"dd a 
new cil h'jl mile 1 ml ted seats: 



6flight * seats 

But what do we net^fl rlii 、 J lUhre, 'vr ]i^id a Flight ^ihjec i 
wi! wajiied 10 kiuivv what the r^lat^d sc^its um 丁 I it* difTerenc^ h 
il iat now weYt_ checking a seat obieci, and to do thtu \ve nevd to 
know about tlir 1 rhied flight. So what n \ of rclatioiLship eki we 
nmf Ihh shiu- unwind? 
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making 





Wc need the REVERSE relationship 

This Linir wt fc nctrd a rtlidoiiship 1 hat's lht. K opposite ivay around 
the one wc had bo lore. Given a particular seal object, wr nevd 10 get 
the related flight: 



\W \\ r ；im lo havp an aitnhutr on seals like ihis: 

@seat.flight 



J his 七一叱、沪叫 Irorn Seat to 
the flight +*- ^ 4 *ve h jeai 

! lir 


Wc want to know which flight a seat l>clong^ to. And each seat will 
have only one night. How do you ill ink rhat ui]] coded? 



Rails Magnets - - 

To get related flights from a seat object, you leed to add code to a 
model But which modef and what code? Use the magnets below to 
fill in the gap^. 


The relationship will be defined on the 


model, and it will be a command that looks like this: 




The jf condition in the above mode! that uses the relationship looks like this: 








& at H \T] □ 



yotf are here ► 
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Hails Magnets Solution 

To get related flights from a seat object, you need to add code to a 
rriodeL But which model and what code? Use the magnets below to 
fill in the gaps, 

f^Tl 

The relationship will be defined on the L M _ f model and it will be a command that looks like this; 


The if condition In the above model that uses the relationship looks like this: 




reverse the 


^ l 



So what does the Seat model look [ike how? 

Let's make thr changes ^ the Scat model: 



app 


claw Seat < Activemecord. ：Base 
belongs_to ^flight 
def validate 

f baggage > flighi:.baggage^iloanee 

■ 一 一 _ k- a j-b n 


views 





seatrb 


3 . 




end 





Update ypur vcr$iori of 

XO rridtdi 七 hiS 你之 . 


ht 


■MX "^odc I 
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making c o 1 1 ^ - ^ - n .s r ? .s 



resr DriW@ 


■So whal hiippms if you try lo rt^ervm st.al with ha^r^i^e 1 in excess ol' ihe 
allawnnce for ihe fliglit now? TVy k out and sn_ 


• * 

■ ㈣ T _ r - m jr . 
igypatfEjn “ 

Listing seats 


J 弋 ^M^ct vd^tiehship Cc^bmc 

to Ukt dare ii, e ba^e frobW 




^re here ► 255 


Wooh + Looks like 
we better leove the 
rum behind... 











bullet the 



^^BUIlEl POINTS 


■ Breaking your page into partials will 
make it easier to maintain 

_ PartiaEs, templates, and layouts are 
the three types of Embedded Ruby 
fifes 

• Partials are used to generate 
fragments of pages. 

_ Templates create the main content 
of a page. 

* Layouts are used to create standard 
HTML wrappers for pages. 

■ Partials can be called by templates 
or layouts. 

» Partials can be given local 
variables 


_ Partials must begin with _ and end 
with „html. etb 

_ You cat! a partial using the render 
function. 

■ Relationships make it easier to find 
connected data in other models. 

_ Relationships work like finders 

■ has_many attributes return arrays. 

■ belongs_t o attributes return 
single objects. 

■ You can create custom validation 
by adding a method to your modet 
called validate. 


il^ereiiire m 

Dumb Oue^ion^ 


Do I re 卿 have to break my page 
into partials? 

/\: You don't have to, but a larger number 
of smalfer files is usually easier to maintain 


How do I call a partia! from a 
layout? 

J\^l Using the render method, just like 
you would from a partial. 


0 ： So it matters that the seat fable 
column is. called flighUd? 

Yes. If you didn't use Shal name, Rails 
wouldn't know to build the relationship. 


Qj Why's that? 


A: if lhera's a bug, it wi ： l! be easier to 
locate broken code in lots of smaller files. 


Why else wou id I want partials? 


For reuse. If you have a standard 
menu or ooniact section, you can reuse it 
between different templates and layouts. 


So do relationships cause table 
joins using key fields? 


Did it matter what data type flight. 
\d was? 


Yes. By ddault r relationships work 
by connecting Hie id fm\d of one table with 
another field ending _ i d in the other table. 
That's why Id on the flight t^ble connects 
with f 1 i ght Id on the seat table. 


j\: Good question」t nwd$ to be an 
mleger, because that's what F?ails uses for 
id fields. 
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making connectiof 

Extend the custom validator to also check that flights are not booked beyond their seat capacity. 

[Hint: All arrays have a method called size that returns the number of eiements in the array,] 


class Seat. < ActiveRecorJ: : Base 
belongs_to : flight 
def validate 

if baggage > f1ight,baggag e_a11ow a nee 

errors _add_to_base ( rfl You have tDO much baggage 11 ) 

end 


end 

end 


you are here ► 


257 





size rewrns 



goLytlOK 


Extend the custom valsdator to also check that the flight is not booked beyond its seat capacity. 

[Hint; All arrays have a method caEled size that returns the number of elements m the array.] 


lass Seat Act. i ve Re cord : : P，a se 


belor.q, 


;fliaht 


def validate 


baggage > f 1 ight ¥ baggage a 11 r-wan^e 

errors , add t：.- base ( 11 You have too much bagqaqe r, ) 


end 


if fli^htscHs si« . 

tirV-<irs.ddd_to_bast( 11 The flight is ^Ily booked ) 


find 


enc. 


e?td 


r 


tfiereiQre m 

Dumb Qiiestipns 


讀 「_ 


0： 


- H&y ■ wait a minute... Why is that condition rr >: n 7 Aren't we checking fo 『 
wh&n there are more &&ats than allowed? 

A : We are, but remember-a relationship works like a finder When we evaluate 
flight * seats, we are reading the seats from ttie database This validation check 
is running before the new seat booking is saved" to the dabba$6, so the current seat 
about to be added won't be inctuded. Thafs why you need >=. 


L 











Tqst Dri 赃 


Make all lli> h rhanges iVom tbe previous pages, and ( herfc aui dip app a^ain. 



llitf pdjre nt)\\ lists, tht lurrect .seals For it it 1 But wluil 

happens if sonieoiif Qics to book a seal on a lull flight? 


mBking cq/j ?•• 
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coconuts ck^} 


The system's taken off at 
Coeonut Airways 

Life's pretU gtjotl at llit- ahUii^. Touriiilih aiid find it a 

breeze to use die s\^tcrn. Hie planes don't gei o\ ei lo^tded 
with baggage or get ()verho"bxl. In fact, tlie staff arc 
lining tlie time they saved a little more piwiur iivdy- “ 
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Tools for your RaiU Toolbox 


You’ve got Chapter 6 under your 
belt, and now you’ve added the 
ability to make the most of your 
connections* 


Ra'iU Tools 

r^r ㈣ 命 〆’ 一 ㈣ —— 如 — 
Pass a Enable to a partial w 仏 

代 —r 干 ㈣ 二 (•卜 

validat_ a -eihod 

catted valicb^ 

bcl^> dtUts. a ^lai^sV'-p ^ ^ zti 
\h ^aveht 

Vi rt 贼 relab^shif 










7 ajax 


命命 

^ A voiding the traffic ♦ 

% 



She's fast, respansfve, 
and h<is o dynamic 
personality. 


People want the best experiences out of life … snd their apps. 

No matter how good you are at Rails, there are times when traditional web apps just don't 
cut it. Sometimes users want something that's more dytiainic and that responds to their 
every whim. Ajax allows you to build fast, responsive web apps, designed to give your 
users the best experience the web has to offer, and Rails comes complete with its own 
set of Ajax libraries just waiting for you to use. It p s tirne lo quickly and easily add Ajax 
goodness to your web app and piease even more users than before 
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server 


There's a new offer at Coconut Airways 

(Jnconul : Virvvays has iiilmdtirechi nrvv ]>ronii?Einsi!hl thr la^i 

\hrvv stilts <_i] t fc Vt fc ry ilin'lil .ne on r M half jirk.d 

But ElifTt’s fi pn i E'vtTytw i“ ^ral> t] i.p [in; : il 

iliriee sentSj and so in the la^t hour or lwo before the cluM k-in rlose^ 
rLlSl^miYs m'v i ： :onlinLLciII\ i likhii^ lilt 1 rrlijad luiUcuts on Ur iHtuvsi'i; 
in dir ho|X^ of getting Ei clu^]j (light, L ntbriiiniitclv; the increaso in 
traJfi* is pulling en< n'mous jirrssmv tm (lu- (■: or"nus .VsiWisy^ servm 



Cheap flights? Cool! Ill 
just have to make sure 
I get in there first. 


click 


o\\o^ 


Oh man 


this 


is 


gpving 


such 


headache. 


r 


me 


a 


need 


ie down 


to 




a 




tV^e ?ay 


C ’’ e + click 


：VkC 


^ canS , 

hri^t or ， the and 

ba^dwid^ yUrnj soakcd 


click 


The t^xira. requests are causii ig the Coconut Airways site to slow down. 
There ami ninny pt nj^lo rer|i ㈣ iiig min on ihe Highly thai ar^ tii>se 
in rj( , pjirtiirt , 4 \hi\\ odirT usn、;irc lia^. in^ pmblems pming ihron^h (o 
i 1 w v..d) sili* lu Injok seals on ihvii Hi skills. Ci Hnmii Ain\ays iirecls vou 
Ut iu.<r mu>ther li »>k aL {hv Lippli^TLioii Lind ^av if {hew Is feoi'in/ way oi 
rcdiiL'ing ihr “iiimmt oi tmllu lliat s llnodiiig intn (In ； wel：i server. 
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Which parts of a page change most? 

I hr majnriiy of' ihe n^iwork ir^flir is roming iti to the flight details page 
lliaU liTllt sill ， is like <mt h llud \hls llu B seM l)nokingH tm the fli^liLp l liis k llle 
page gcticratetl by the icinplate at app/views/fliqhts/show .html- 
erb and the . c .;eat_list > html ,erb and new seat * html, 0rb 
partial, r l here are ihii*e major secrir?n^ to the page: 



Whenever a m^v presses Hie irloaci i>nMon on their browsei\ the entire pagf h 
is T'equt'sied from the sn vn This means lliat th^ sen t'r nfs a ds in 
ilie pLi^e agai[i Inini Uie lempkik^ ami dit fc pail i t ih y and the eiilii t- tiling 
Im to bt 卜 wrapped in the (light layom. Now, if there are just one or two 
requests going on at nne lime, this rcaUy isn't goin^ to cause a problem, but 
the server is being overwhelmed by the amount of processing it has to do, 

h there some way we c an reduce the load on the ^i\cr? 


The flight information 

This roniains. [he 1， : 1职叫 ” ^Ho^vanre foi 
Lhr flight anti thf nick>iiiiiuni number of 
nts a\ r ailable. 

The list of seat bookings 

All of the curiTiilly l>f>fsked on the 
flight are* shown 

The seat booking form 

Vscr'A need ihi^ to . Lcmallv hook a seat. 


Sharped your pencil 




Here's how the pages are assembled by the server. Highlight 
which of the Embedded Ruby files you think is generating the 
updated information that the user is interested in. 



I Layout | 
flights^htmlerb 




Partial 


Template 

1 r _new sesit^ him i. erb 



Partial 


^how.html.erb 




seat list html.erb 
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update 


r fcSarpen your pencil 

Solution 


Here's how the pages are assembled by the server* Highlight 
which of the Embedded Ruby files you think is generating the 
updated information that the us^r is interested rn. 




Layout 


- ■ 


l.erb 


flights.htmE.erb 



show.hlml.erb 


Wc need a way to update just the scat list 

W hen pe*oplc j relVfsh lh^ nn>s(. nl il dnesn'i rhan^e. Hie % >nEy pari iliat 

isrYt-r iiktrJy io lx 1 dilTerenl k ihe serLiuiiL dispJiiyiiijr seat bookings. 

So what ariiKilty Inippnis when a user clicks die reload button on their 
hrnwsrr^ Wdl ， "Reload"' Ldh a browser in ref|kiesl. itit* entire a^ain, 
cuid iJuit’s btmuse lilt ， tfiUiri 1 ts tht h only llinig ihafs aviiihihlf. The 
application dot-si it cun enlly allow a browser to ix-quest anytlung; smaller ： It 
may be the case that ihc only in (cresting par") I the page Is the list of bwikcd 
seal、hii the browser can onfv get ihe 叱 at lisi l)y l^questiiig ihe entLi'e page. 


T L 



The first thiriff we need to do, then，is nnodify the appliriLEicm su ilmi ihe 

iiUeit'stiiijr part of lilt 1 web tliu lisl of st - 應 一 is availalile by a separate 

request. V\t need to aDowa browser to request a pariieuhir L ! RL that will 
generate just the seat list. 


77 c 


「JU 


V^AIF 7 

uQr / 


2B6 



























ajax 



Sharpen your pencil 


How would you define a route in routes * rb that would match a 
request for / flights / : flight _id/seats to an action called 
f 1 ight seat^ on the seats controller? 


i-»• 


+ FB i l+ + -9 a B4 + FB4 i «- 



CoJe Magnets 

Com plete the flight seats method in the seats controller: 


def flight seats 

■ ■ 


{params[ 

a. 


]) 


=> ,:locals—>{ : 



end 


@flight 


flights/ seat 


list 
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re-route 



Sharpen your pencil 


How would you define a route in routes , rb th^t would match 
a request for /f ligh 匕 : f light_id/seats to an action 
called f 1 ] ahL sea tfi on the seats controller? 


id/scsts^j '-ftmVit scdts\ : ton-tI 

+ fti hi ri + dfri»r + 圏 4>l+«44 + l<R» + +B>iJ+4-i !!+■!!■■ >1^1« i a ■ ii- + + k 4 + -P 1 4 4 + F V «• + !• P B- -f li fa i + + <li ■ i + 嘗 i_ W _ # + 4 •讓 ri +-i 1 4 + + P I >1 + i 4 •§■ ■ ■ i> + + i fl ri + + ■ ri it + li S fl ;«• + h 



"V[ Code Magnets Solution 


Keener add r< ^ 
top f 


Complete the fi 1 gh t se L it s method in. the seats controlier: 




def f1xght_seats 



end 



coconuts 



config 


routes.rb 




□ 


qhji l^StTk 


app 


ttert s _V^re 
i md ^ +llCS 



controllers 

seats controller.rb 


〆 



Tjo f^Js? 


Add the two pieces of code above to routes. rb 
and seats—controller * rb 
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ajax 



Imagine there are scats already bookec] on the flight whh id = 2. J[ we go to: 
http: //localhost : 3000/flight s/2/seats 
whatslicjuld we str: 1 


O n o 




diei. + 


Listing seals 


Fl! 4lht 

S.mt 11_ 郎邏 |** 

Rnwl S.ftirpcmii 

BUD 

ShQW 

Ktik Amy 

15£f 


Drc* Dcmilttic 

1 ⑽ 

Sbi» 

Jon» 巳 JjJy^ 

29jO 

Sbow 

Gaflkncr Bnllikst ZSJft 


Trt in 沾 m 

190 

ShQ w 

Jctie Cw 

n& 

Sb^w 

J*ck Cw^ 

280 

SM* 

Tom HiJpiL^ 

ISH 

Show 

H 柳 

!SH 

S 加 w 

SiefW Kmli 

17fl 

Shuw 


t4ll 晒 
Ujt |X 、 啤 

SMQasw. 

Pn 贿 

Edit Docn?) 

Edn ⑽赌 
BdlJi Dotm) 

Ekbi 


Tlii. routf that wl created should map / f I Iqhts/2 / se^ts lo ihc 
f light_30ats action and Eiie seats tonSn:>ller^ as well create 
a new request parameter called f light id = 2. Hie coiitroliei 
lo(sks up [light m]nibe] 2 irom llif fc and ihvn some 

HTML Irnm ilu. : l. list partial and return il Lo [he lirowssr. 

Take a look at the HTML thal the conlrc^Iler generates over on the 
right. \Vhat da you no rice? 

The Hi 'M L (hai get? rmimed \mi actually a fid I web page, ii\just a 
web p^g^Jiragment. Bur wh；n nvc we pfoing to do with that? HV rairi; 
jusl r^qu^ sl Imik al liiis p:i^f inmead n! ^ Lo iht 3 fti^hL 

as ihi.il vvonl lovk very ^ucid. After : dl ； in soim fc paiiiL ihe users w ill 
wani to place a t^ooking fur a : sm so \vc wutvi the users io remain on 
the flight page anyway 

Srn]it L lLow we need to get the browser to request this page fragment 
and then u^e it lo update the list of scats on the page. 

But how? 


<hl>Listing seats</hl> 
<t 3 ：> 

<th>Flight</th> 

< th>Mame</th> 

<th>Baggage</th> 

</tr> 

<tr> 

<td>Brent. Chsse</td> 

<td> 19 - 0 < 7 td> 


Heres ihc page 4 a^cni 
that the domiroJIcv ^tr^riie 

Wovn ^ 卿 tjist paHiaL 
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browsers update 


doesn't the browser a[way$ update 
the ewtirc page? 

Al [hv mumoit vvlirn thr user hii^ [\w "rrloacr' buitfsiu the bixsvvwr 
the entire wx \> page: 


O 

0 



Ok, I need the 
whole thing. The 
flight info, the seats 
the form... 





11 ir lj:id ji^ws is that's all the hrowser ^j7/ ever do, ImiH r('qitests : sre 
hardwired inio the browser^ brain. The “ifluiul l>uun" !iu j ans ^VelDad 
(In' miii'C LhiU's u r licil lii ： ip|x p ns.,.. no iiiitilcr wlial 

Bui wiv；^ 

■i 

Under the hocxL browsers only w<irk with entiiT web pages. There’s 
nodiing in HTML tii-u ;.l]]s i\vs a hrowsser 10 recjUiesi jvi^l a pari _>fs pagt s . + 
Un :dl n rLrsLhhi^. li thn^ii'l iiuUhT iIki! wv\v how di 【 )1. 

I he [.usblirh a\ 7 tiiJiil'Jr, i Jicic's no U'ay tliEit lJic Isimvsrr ui.i its <wn 

can iisk liu; iind use. ei pago IragmenL 

S<> fiuvv tin wc gti aroiEiid thi fc pi^ol Avm! 

FortynatdB fur u% ihere% a irwk we can use ■ gt*t thr bn>vvser io update 

juHl a pui l <sl ci paj^e. 丁 lie Inck is: 

Ve grt Sametidng Aanflie 

browser to make tiie revest- 
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ajax 


So what ELSE can make a request? 


Living inside iht 3 brain of every hrc^vsei 1 h a JavaScript engine. 
JavaScripl ijlcjws you io modify Lhr normal op^ralion of Lht] bnivvstT. 
■Jitvaik.j ipt Ciixi dyiiaitik'tilly t:huii 取 tin.' ^pp^Ltrancc ol a vvcb page, it 
tan update the auHcnmd the H i AIL that is (Ji^playccl, and ic can 
respemd to eveno ： uithin the page, such when hum)ns are pressed. 
Most in:p o rra n 11 %; Sr rip l ran also make requests indepenrlenl of 

ih^ browser 

But wliai do^ independent really mean here? It's true Ehat 
Jm aSrripl rail Sell a brrm^tT io gen (o gnotli^r pag*% Imi it am ohn 
dn inud] m<lit! sulitle. In llu 1 !jac■ kyri mn d v |a\ r ikS(■ ripL 

can quiLily make requt^la to a web ier\ r er and read i\iv conioutis of 
whate\ r < t r the senvr ^nds buck. And all this can happen without taking 
the hrow^'r lo a dijpmd URL Ja\aScript could make dozens, or even 
hundreds, nj' back 疚 round requests, and you wouldn't notice a Ehing, 
The browser would look like it was j as I displaying a page, 

Tlie reawn why this is important is ih at JavaScript can make a 
background request, or asynchronous request, asking Ibi ihe 
latest v-ersif>ii of the seat list. When the page fragm^nl is reLiirnt*ri N 
Jii.vaStTi]>l i.：itn usl. liie Iriigmcnl tri updalr ihv sectiun of lJii K page 
displaying the list of booked ^cats. 






o 



LUHti v \ 




Wc 
tke 


=Tf 


tsn wsc JavaSoft instead 
w browser b> wlcrtk 
ThAi way wc won’t need U rfioAd 
办 e W the d 〒 a 乎 

will seem a \<fi 喊 e ㈣- 


UsingJaraScript in update ihc CLim nt page Ls called Aja\. and Rails 
corner \\ \ih a lot of Ajax support built right in. But how do \vc use it? 
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rails has 


First we need to include the Ajax libraries 


Reii how do we ■ t Ja\ p sS^ l ipl \n the browser to mtike as\nrhrcmoys 

Tluit kind of processing is likely to be quite complex- The Lmdi 
h \iic\l then: is a \ w\ W 奴 iiiiiiuimt ul JavaScript rude diiU nrrJs iu run 
bis id c the i)ii)wstr lo make Ajax I'equc-sts., I he code will not only nt-ed 
to hantlle all ot the details i >1 the i^equesi pRH e^iug, biu il will alra need 
m do it in a uay ihai k comShip with all (Iip major hrij'vwr^ Thai 
v\nu|d In ni^bsm^iro In crfeitc' : sm! d^bui^ itsosi \\ax iippliralirins us* 1 
sLmdHid JavaSkTijjL lihntrit 卜 h k> makt 1 [ifi 1 msier Ruils t:times \\\lh (me 
mch library buik In called Prototype. 

Tlit 1 Prototype lihmry li\ es in ^ file named prototype ■ j : ii] Lhe 1 
jti\ r a&cripts ioJdor. Bm even 1 hough die library h included ii^ thf 
applkaticjii code, il\ not. automatically includes I in the wel) pagts that ate 
gene rated l>y ；in application, lb make sure that Prototype is available lo 
the hremw. you need lo include a leference to U in v<mr Jawnts' 

，-〆 if / 



public 


^ Jav 自 scripts 

I 、 prototypeJs 

( L , « 
The pvcrbstYfc > 七 1 

r s s ■ J ■ -Ijf 




Ih 


kJ a ■ .M I 


towC 4 bundltp 


: h 





-- XHTML l.o Transition! 

<1D0C TYP E ht.1 PUBLIC ^ 11/DTD/Khml i-tran S itional ， d,d 

<htmi 祕 〆 咖™ m 邮娜1， xmiaang - - - 

http ^ q oiv-can t ent-.ype- 
<_： a http eq^iv action name %></title> 

<tit le >Flights ： <%- controller-actxon^n 

stvleS heet link_t^g 'scaffold 1 %> i_This lint hew ^ that 

- ，一 : 一少 g ■— 一 > 

</head> 

<body> 

<p s M color ^ 

<% ■= yield % > 

</fcody> 
c/html> 


> 


gr&eri 


,T >c% : 


flasht notice] %><_■$> 


i lie j avascript include tag helper makes surr the browser 
downloads (he Protohpp library liY>m the correct I'RL. 

Once you've got the Ajax library Installed in your web 
pages f you're ready to create some custom Ajax code. 


app 



views 


)layouts 





flights 上 tmlerb 


272 



























ajax 


...thew we nmA to add m Ajax "Refresh" link 

Th*- 1 Apx lihraiy makes it easier io make asynrhn>nau>i I't ruie^sls to iht^ 
server, hixi what i]\v library woifl d" is uriU j the rtLslom \\c\x t^nJe I hr 

Vo a. So vdutt custom code do W'e nrcd? 

■ 

Tin' network pmhieni is mused l>y the reload button 

on tlicir bru\v 、 tTs h uliicli Ls making the sysk L iii slower for lh[ni mid 
for other users. Wo can got around this is l)y giving the users a link 
in the web page labeled u Refresh.' 'Ihk link v\ iJ! jus I update the seal 
besoking^ on ihe page, and because h、dovvnloadiug I ⑸ HTML, ii will 
be faster for the user than the hrow?fr ’ 界 “Reload.” U will al^o reduce 
i]w If Kid on lhc k Hf'rwr, life easitT fbr olhtT tMislameiM* kia_ 

So ho\^- will the "Rpfr^sh link vmrk? Aj^x is nm nihrdy hy JavaScript, 
sfj wt* need the link io ^nenite □ Ja\ r aSrnpL mill. Tlic* link s evetH 
will call Lilt 1 Pniloiypt 1 liljrary m id Lell il l(» make a rt c^LUf^l [hi thu latent 
seat list section the page. \Micn the 11TML is rciurnccl from 
the I>ravysei；JavaScripi will dynamically i^eplacc tlic tm the page 
with the new HTML. 

So what should tbe code look like? 
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you know 


you think 


parpen your pencil 

k Solution 


This is the code to add a JavaScript link to the Flight 

i;how . ht.ml . ^rb template. Write down what you think each 

part of the code does. 


<div id- M seats ,T >.ihc.F.fti.frf . . . .. 

<%== render : partial=> M seat_list ir r :locals=>{ : seats=>@flight*seats} %> 

</div> 

<% ， iink_to_remote ( ~ 

"Refresh 

: ur 1=>_./flights/#^ @flight ■ id} /seats T _, t~TKc.!4Klr..vhcrfi_tbf■ WW,J*?t ^)l\ 

： method=> l1 g^t M , t~Xhis.wc ,jwi xt^dm%；.mk ^4*t.data __ __ __ 

: 11 36 dt>s ~■’） ^Skc^id.#tbit t 1 ^^il 兔 - ■P 4 «+FP+++»a>i»++i 4 H+«fi 

<%= render : partiai=>" tiew—seat ’ 1 r : locals=> 1 : seat => 

Seat .new Uflight_id=^>@ flight * id) } %> 


When Eriibcddi'd Ruby piotesst.^ \hv show - htm 1 . erb teinplatL% it 
goneraics an HTML link that talJs the Ajax libraries when it s clicked : 


this ffTAJL. 


Oh 




:/div> 


Mu 


<a href ^ 11 # 11 onclick^^new Ajax , Updater { 1 seats p , 1 /f ligh 

1 r {asynchronous : true r evaiScripts : txu& f method ： p get 1 f 
p^ram^t^rs : r a\ithenticity^token= T + encod^URICoiriponent { 1 7cb578 
032877Se£35ee9d2€6B9784bba0d562170 ^)}} ; return false; '^Refresh 
seats</a> 


<hl>Mew seat</hl> 


274 


ChaDier 7 



























ajax 


tli^rBiqre Ti9 

Dumb t uie^Qiis 


What's an asynchronous request? 


o ： 


How does that token work? 


An asynchranous request is a request that Rjns in 
tiie background Asynchronous requests are generated by 
JavaScript. 

Q: So how does that differ from norma! requests? 

Normal requests are generated when a person dicks 
on a link or types in a URL Asynchronous requests are 
generated by JavaScript Fn response to an event. 

Does reloading tN page really up that much 
bandwidth? 

/ It can if large amounts of HTML are required for the 
rest of ths page. Also, the browser may attempt to reload 
images cn the page, which can aiso take up a significant 
amount of bandwidth. Pius some parts of the page may t^ke 
a !at of processing lo create, Ajax allows you to leave those 
parte of the page to remain unchanged, reducing ths (oad on 
the server. 

Do 1 need to know JavaScript in order to wrste Ajax 

code? 

A- Rails will generate Ajax code for you, so you don 1 ! need 
to Seam JavaScript. If you know JavaScript, however, you will 
have greater control over how _ calls are made, and 
be better able to understartd how your appEication works. 

The generated JavaScript creates a param&ter 
calEed 'Authenticity-token^ Whafs that for? 

/\] An authenticity token is used by Rails to ensure that 
a deques: comes from a Rails-genercited page Without the 
authenticity token, Raifs will rejecl the request 


J\l Its a value generated by Rails, The presence of the 
value in a request show that a request is from a page that 
Rails created and not from some third-party application that 
is trying lo access your system. 

o 

You 骂 ay th^f requests are sent out by 
J^vaScrfpt Instead of tile browser, but isn't JavaScript 
just part of the browser? 

A：^butthe JavaScript engine can make requests that 
are not part of the normal browsing sequence—and thafs 
the point Aja^ requests allow you to update parts of a 
without makiog futl page requests and without modifying the 
browser page hislory. 

o 

Why did we use the javascript Jnetude tag helper 
instead of just entering th& HTML to bad the JavaScript? 

If you want to wite HTML for yoLir$$lf, straight HTML 
will work, but Rails developers te^d to □&& helpers whenever 
possible, Helpers are usually a littEe shorter tJiari Ihe 
literal HTML, and they also fifl in some application specific 
configuration for you. For example, the javascript_indude_ 
tag will U\ in the path to the standard javascript path: 'V 
javascripts/._A. 


The helper also adds a random number to the end of 
the JavaScrfpt locstioi. 


It means thal if someone refreshes the page in the 
browser, the brow ser mU also down [oad a new copy of the 
JavaScript library Thai way, if you change anything in the 
library, the browser will always request the latest version. 


(七 What use js that? 


Q ： That doesn't sound iik& that big ola deal. 


you are here ^ 
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test 




Tqst DriW@ 


Nnw th?it iIip JavaSrrips hnilcm is in pl^ce. U s time eo see how 
Lhe applicElion's lookiiig. Reload your app and try Lhin^n ouL 


© 


The first user goes fo the 
flight page to book a seat. 

E 如 sees detaiJs of the flighi as wc\\ 

eis \\w Hsl nf fihTadv lionk^d 

Lind a bcxikjiiy fijrni^ Sitting 

txlY'dn tin. scdi list iu\d \h »oki i ig 
Ebrm is the new Ajax button. 




A second user visits the page 
and books a seat. 

When U]e forni h siiljniitLed her 
page is rdresiled And ^lit 1 hur 

m ： v\' boukiiai^. So will mrytmu whu 
now go^s to the page. LSut what 
about the first user? 
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mnn iwj 



修 


The first user can see the 
new booking by hitting the 
refresh button, 

Ijuitoii lures i：ifi :: lJ avaSkiipt 
event Eliat will call the Ajax libraiy 
and rdiah Uie seal list, showing 
the new booking. 




Thf syslern works Lfrtut ， btiL a frw ustrns 'atv vvdiidt'riiig 
why they hii\ r c io sin xhcrv repi^tLcdly dit king a ijLilioii 
just to see if \hcrc sire new bookings. It wouJd !>c much 
iTKire convenieni U the page could somehnw cli^cover 
whrn thni ■: ;irr nrw bwking-s 叫 rally. 

But is that possible? 


But why do I have to click 
refresh to see the changes? 
Can t the system update the 
poge automatically? 


you are here ► 
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g/mmemorcf, no 

The browser needs to ask for m update 

[>i il I liri ■!'-. .l I m il ilc m with .u"_ ini;tU> alh i ij m l.di]^ 11 11 - [ ■, ；uid il 

rojnt's I'mui lh(* \vn\ lluu Liu 1 \\cl s Works. 

■ 

III a pfrftvt ^vorld, i\w wrh jippliralinn wmikl Im s ah]e lo le([ ilir n^r 



11 k 叱 mT will nnl\ st L iid u tespottse if ii gets .i request. It tiic server 
ban new information that it vratits to let the browstkT know about, it can ! 
dsj nmilling, U so wail Un tht、hmwscr … asf； thi the 1 n^w mfbrmiision, 

Thitt moans ]f wc want ihc browser U\ automatiadly be h]kl whene\ F <T 

■ 

(he ^cai Its I chun^es, wr re ■<_ he dhapjxjimffj. hi^icaii wr need the 

browser lo jusi keep 邪 kin% And asking. And aski"s … 


™ ^ set 咐 … 





and 


rV^ 
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Put SHOUIP we make the browser ask 
over and over again? 

Iliuik lxic k to tlir the Ajitx ivli【、h liiik wstfe. 'Vlim sunn onr 
dicks un it. ihc litik generates a JavaScript cwiit. which in uirn calls 
the IW"typr tibi^n; ^stiiiL| ti rJcjvvnlrjiid a ru‘w<，r ihc s^st lisu 

I h__ kry ]>uint is ih^il uli"k. thniy bcpiis witli cin mv". ^Hiit-Ehmy tlirit 
h 明 ) uis outside nl Jm^aSc i \pi . 


Evlmi[s 


JavaScript Engine 


Mouse click 


Mouse Jrag 


rr 




_ Jml 

v 



4 


t 代山少 W 二 


taptunci tK e €wCh ^ 


JavaSci Ipt Code 



i-nd ^Vi€n tsIU 
Js^dEtlriPt todt 


A pit^e of Jax^aSnripi can rt.gisicr itself wil.li an ^vruL iTiesinMi^ llisiL 
uheil llu" t'Veill sxc tirsj, UleJa\i^StTipl runs. 

In our siiiiHtkiii, wt ' 1 Ti^td tes mu thv SEitir pi^rr of JavaiKcript miT 
and ikVt T r eL^aiil. Sej ulmi kirnl tnviil uii do [Utii? VVelL i,L vvoii'i l>e 
an LAvnt y;ciK L rL'ift*d by ii iiLLinan iithtm. Imlnl, \\v ii 〔 x‘d k> rrgislrr 
JaviiSciipt witli a tinter event, 

A Imivr is ；! hVstiTii ihni ucrurs vn rt^'uLir iiilLTUiis, usiiiiJIv ever 、 
few secondfi. We need to create u i n i ici ； ihru n giwi i]k. Update the 
aeat list’’Java Scrip 言 with it- 

Fortunately, Rails can help us. 
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timers 



You listen to a timer like you listen 
to a button 

r 11 is 1 fully c.lifrt , rciu , ( H IjL'lwrn i Liimiiig j iA 

t:odo \Uien ti buth ni is p 】 vs 认 .d and rumiiiig ii ^ >\vr ;nid ^ wcv 
again e^vry ii^v srt'nntls, iv ； i]ly just comes down to exactly 
uhai kindevent ycai ate listening to, 

Kh thiil reason, the Ruliy t ode wr pku c into the page 
tc ： -mpJvit^ is ^dually quite similar to the code we used to create 

ih iiSn ipi Inittniu 


A h C l«r to 心必竹铋 1_ 知铋 a 知他 

广 n 1- 

<%= periodically_calI_remote{ 

: url=> M _■ URL wVicrt t!hc new scit lisi will k^Qf^ 


: method^ 1 ’ get 11 

: updat 辟 >"_ 

: frequency=> IF 


m 


") 


Hrn means W jud ： nd ： data 

T^iis h thtf id ck {he pirt tJc -the wcVc uipdatir^ 

%> f\ 

T^c 


k^Ul^vf 


^ ^£ohds bcWcft 七_饮 


This coclr win rr^ciir JiiViiScrip! to mak^ ^ request for a ne^v smi 
3 is I every few seconds. Il uiit llitri UjidiLte lli^ sp^f Hied par 4 ! nf 
ihv ptijirc will I thr H [^Ml, tliiiSV ivUirni.'J hy tin 1 s^rwr. T]it; tml\ 
imi diilcrci'K'O Imuui this 1 r_1]xt and il w ctxlir fliat t ixvitcil (iic 
jmaScript button Ls: 



I Ju 1 hi\lU »n needs i ： LLplk>]i L<rxu 



l lie iimtT m: s cls it) l)f giv^.n a Ih qiie-ncy. 
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ajax 


The flight page should still contain the Refresh button," but 
it aiso needs the timer code. Write the timer code to add to 

app/vlews / f 1 ights / ahuw . html . ^rb to make the 

seat list update 3 times a minute: 



v^harpen your pencil 


t/^reiare n9 

Dumb Quei^iQ 


ns 


(v 

Is there really no way that th^ browser cm 
o^nt^cted by the server? 

A: The browser could maintain an open connection 
wth the server but that would require a large number of 
connections for eyen mimimaily popular applications Polling 
the server is a muoh more popufar approach. 

Is the frequeroy of a timer always in seconds? 

j\ : Yes, Vhe frequency is always in seconds. It might seem 
odd that it's called frequency because it doesn't give the 
frequency (how many times it fires a minute). Instead it gives 
tlie ^period", which is the amount of time hetw&&n firings 


What sthe default frequency? 

/\ * By default ttie frequency b 10 seconds. 


O * Where does the id o 


f the part of the psg« come 


from? 


/\l Each tag in HTML can be given m id, Tliafs a unique 
reference to it art a part of a web page. Usually Ajax apps 
wrap some part of the page in a <div> tag with an id. That 
allows you; to give an id to a smgle tag, or to a group of HTML 
tags all at ono^ 
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clicked re fresh or 


parpen your pencil 
、 Solution 


The flight page should still contain the "Refresh button 广 but it 

also needs the timer code. Write the timer code to add to app/ 

views/flights/show . htrnl, e rb to make the seat [ist 
update 3 times a minute ： 


1 ■! + + ■ ■ 1 * P P- f + -B i i * + F fi S- ■ 


— period Iy C^W rcmo'tcf 

B 警 ， P P 警 - ■ P 麵 T 1 •! 蹋 + 寺 B S + + P B S * + ► I- i S -O' 警 J •¥ * f S ■ + 


+ !■ P ] B 靨 


■ + P» i 1 - fr 


^ + *F P B- 


+ + « B S» + + i 


f tidh^s/ ^(^l-liAhtid}/ sc^b^i 

§■ 4> + « B B++S S • + + « i §• + P a .P f ■ V f^h ■. £ m ，警 , 鼉 +-4-11 + ■?¥ + + §■ ¥€•§■ + ，韁 、 ■ ** ■ 




+ + •■ ■ . + ■? 6 


■ n ■« ■ i x ■« 


I 亂 ■ __T E l^i» ■ h it- ■■■■>_ ■ fT 1 ■•% 


■ "R ■ ■ pr 


n. > ■ ■ ■ ■ sr 


对 d 泌 f 分 Wi ....... 

^rac\uc 


— W !!■ 


\biir show. html - erb template ^lioukl con lain k>oking iikt 1 ihis: 





he tkof-fcoih p^L-i r 


flight-bagg^e.allowance 

<P> 

<b>Capacity ： </fo> 

<%=h @flight.capacity 

</p> 

<div id=”seats") ^ 一、卜 c^ats=>@flight Jeats 

,-tial^seat list% tlooal^>{^eacs ^ 

<%= render : partial-^ sedLl -- 
</div> 

<%= link—to 一 remote id}/seats' 

， Refre3 , seat， % ： url^Vflights/#i0fUg^ ■… 

: method^-get-\ ： update^ 11 seats" %> 

periodicaUy^can^remate ( 

: ur »,7m g hWiHefiighUdW e ^，， %> 

a V,seats" f ;fr e qaency-> 20 

: method=> get , ■ P . loC als=>{ ： seat=>Seat-new 

<%， render : partial^ 11 new_^at , *1 ^ 


%> 


; flight id^>@flight,id) } %> 


282 Chapter 7 






























Iqst DriVs 


Nrnv the limer rode has been added, thf system should RutonialifTiNy update \hc 

K^l I -I StNlL 131 ：-< skEIL^S U 11 In Mil I III - lt^rf Hi ： illlU ； iLltU liillL ； I' ' I'rlr^sll _]k s I 以 y. 


The f frst user goes to the 
flight page to book a seat 

l ie sues details o I the lUght. 


While he's booking the seat, 
a second user visits the page. 

She quickly boofe a scat on the 
flight and mbmits the data. 



New seat 


liame 


爨 no 

- .%Lifui "Wt _gfft_ 】 


Pfk(4C H«w ,__!(#•■ 


fip 1 * l‘4 br tn 

JLiaU 

Ul .^|Efe% 

K'fc 

imnik 

暴 • 4 ■ 1^0 r ipm 

ITJt ^ivj^ 


fill ■"‘】lii a 

New 

V_n>i 

AbHBTT _ Hi 

1 n f** * 

J 




The first user outomaticafly 
sees the new booking. 


l?A.e" ill-High \])v lii-si userdnesn r L 
lunch Uie keyljoiii L d, ihe pa^t" 
autumnticaUy updaLcs Liu ： seat \hi 
within 20 seconds- 





刊？^、 ■ 






* . C I [^^0 fwifrj JOOflwJ 


神 IQ 树 
Hrvint Chfli* 


N*m* Bl^il{]€ 


Term LJVK«b« 

Ovarii Oc 誉 n 

JyAir K 

i CDliam 

Oi^Hi 

， CsM'rt 

3 c 11 r 

J_mc_ 

Mr™ 



IM 
I5.H 
l9.{» 
ILO 

OinrEU 13. U 


kaw 

5^J« 

"SFU* 

5hft^r 

3tnai 


Edit &EHJJBE 
EUjt 如咖 
edit tJainBc 
Lfli ； Hft【m 

HE 

Mil BM^f 





you are her& > 
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ajax 



This week's Interview: 

Getting Up To Speed With Ajax 


■a 


Head First: HHlo t Ajax, and weh It's frond nf Ajax: ()h y^ali. XHRs can bf 3 generated by nlmosl 
y<jLL.„ anyiliing itriy kinc! of JiivaScripi eveiiL 


Ajax: Myph'mrr, 

Head First: „ J r* he imm’trwf ■、丨 Uxliw 

■ 

Ajax: C )li. I IniciTLiptetl you. 

Head First: Y\mis 【|tiUe _ + 

Ajax： I rki ihat a IsI’m sorn ： ^ ^rn hr a Eitils 1 you 
kiu>u、hypen 

H^sid First: Vmi r« B ii bii^y irrhiiologv? 

Ajax; Sev Ehaf/ I jusi uj>cisited the data tabls ； Wliat 
- ,ethnology? Fm no] ledm^.ilogx; I’m a way of life t 
t )r at Irasi si way of ut.iiiiig wel t ripp^. 

Head First ： Haw d< I tou mean? 

Ajax: \ArlL Ruils-JavaScript, Prototype — tho^ 
duck's are software. Nothin' wrung with tliaL It s 
mnl, hm [ m WTn r lxy< me] iliaU hotuppe is jusi a 
support lihraiy tor me' 

Head First; what yf»u? 

Ajax: I ni ii drsigii U't'hakiUr-. II \rm aiak-e 
sy11 (l l e onous Jav aScript requests to update a Web 
pa^e, you re using me, 

Head First: A&vnchronous? That means vour 

p •* 

requests … 

Aj^X* ，-. ii]hTni[>t ihv nt h iiimJ I)]■[uff, yeah. 
Ilie lequeste happen In tJie background while the 
u^r siia on ihf pa^e + 

Head First And aim us t itnyihingcan trigger Ajax 
requests? 


Head First fm WIT}. m”？ 

Ajax: Snn'\； XHK、an. my lit Me Ajiix request 

E^nddif's. “XML H I I r Roquesss" k Uit* prr>pei 

namp. 

Head First： N"\v vou sav vou re noi 糾， thvim, but 

I 1 # f 

pf fc (>ple fin iiihiuill A jax liiirarit^, lUm i Jhry? 

Ajax: You caji write yo\u m owii rode from ihr groimd 
up, I>mi wm' most propic Ajnx lihimies. like ihr 
Ihmrype UI>Nin： I Jhrari^s handif 1 rrt'iiting requests 
itntl thi 1 slLLll' lliat ]>at ： k. 

Head First： And wins nurl uf is i^'tunu^l 1 >v 
an Ajax TTcjunl? 

Ajsx^ \\ hiHr^er floats ymir boiit* babv- Pfige 

li 叩 iinHs ii:i HIM I* 」 hii'A hi XML ur J^ivaSt ript 

Ibm^iL RsL'iiJi^aSt ri|j( ilself! 

H^ad Firstl 1 srf\ I VIi 111e n11>r<■ ^ fa\aSi ripi. + . 

Ajax： U hm’s \h,M Holt' budd> ? Hr\\ sorry elude — 

goltH gri- 

Head First: Extw me? 

Ajax: Sumt onr jusl hil u lwaSmjjt build I got ail 
inw licb rvrul with tm iianmi il. Cakh vnu later.,, 

■' m 

Head First: Ajax, ihank … 

Ajax: l )on'i itiriiiiou ii. 


284 Ch 3 n ter 7 


ajax 


Someone’s having trouble with their 
bachelor party 



I need to book 19 seats for 
my bochelor porty. But I have 
to keep hffting the 'Sack™ key 
to return to the fJ fght page! 


Al ihe momeiu^ wh! j n y(ut \mok n spill, Llit 1 hmwser h 

fbrm lu the 叱 rvt% anti ct dLsipluyiiig liiv l>LKjkt , d scat is tlieu 
tctunii-d la the bixnvHCf. Bui what LT someone newels lo \x)ok a 
wlwiemol seats? In this case, Ehey have lo press the “Back” key 
on the brr^viser la 3 ciurn lo the I light page to boob another seal,,, 
and gel an other ranrirmaUnri, and then hii Back again-- 

So far we've written code that can update the list of scats without 
gr>ing in a new page, i ^n we dn snmi'thing similar if a srai is 
b(joked? Il - the form tmild smnetim' st'iid Lht 1 bonki]^ to the 
server mid (iifii updcUt 1 the list of s«'abi t it would mt^ni liml Lhe 
user could remain on the &£unc page. II Lht) needed to makt? 
another booking; they're already on the correct page to enable 
them to do that. 




list d sci-b ^ 

bookiq {ornh arc 

如训 讲⑹ 
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request wth javasctfpt 

The form needs to make an Ajax request 

If we U h i llie bmw 邑 er subrnil fisnn we know (hat we'll be liern Us 

ciinjllier 】 L、just like the pmblein ut* had u lien llie user hil i\w 

browsLT “Rx luitcr button itbuilt-in brovvstT behavior ilsat \ve 

can t modil v ： 

■ 

Su whiit du Wf ih.i? naud lo use a eJilTtrcrU kind of fbrni Inwluad 

of using a standard HTTP Form, vve need to use a JavaScript form 
and use : hat to tnake a request. 




Insle^tJ uf' simply iisking (Jit 1 litow^r io slibruit llitr H>rm data, \vv 
ncftl die submit bitLLon lo ^ciurrate aJaVciJScripl event that will 
submit t：ie form daia using an Ajax reqin^t, So u hy is dial su 
important? It means that the act of booking the aeat won 'I cause 
die browser lo switch Sr ， aiioiher pagf, 
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ajax 


The form needs to be imder the 
CONTROL of JavaScript 

So we nresJ Uj canvfrl Llit j form i'mm a siinplt' HTTP form inU» one limt 
gciicntks JavaScript events anti dynamically updates tlu. cuurent page 
rather than moving the browser to a diflcrent URL. Here is the contents 
oi the booking ibrm partial: 



But how do we make liiis i\n M forrn w(jrk in this ciniipl^irly difl^rent WLiy? 

We need to change tliis: 

<% form_foE(seat) do |£] %> 

tu this: 

<% r emote 一 form 一 for ( f : update®=> f seats 1 ) do [ £ I %> 

It’s a fairly small change, but behind the scenes the 
form will work in a very different way... 


you are here ► 
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remember the 



Tqst Driwq 


Whn] a user goei? to a flight j>age (http: // localho^l ； : 3000/flights/2 ), 
the booking form I nob exactly as it did before; 


n n ^ 


FH 4 M 1 物 


H«A» !1 ** |V W 


_|J| | 4 rD 

sin 

izt 

19 • 

fe' ! U" 



New seat 



But, of coiu^c, bdiind the scenes the H FML is very 
difier^nt. So whai happens when a new scm k booked? 




cS^ 


at 


Some I hint's riot quitr right- honk in your 

thitahase … the s^aL was Ixioked ron ecllv, ImL 山 e 

■ 

fliglit page becomes corrupted■ Why? 

vv rlian^ed the rodt j iiii th^ vitrw，bill Oir 
l'uiiL roller utjdtr—the code on i\w st' 【 VL j r — its still 
dt.iiny the ^mnv tiling it did Ijclbre; it sends back 
HTML with details of the newly booted seat* 
What we need a new vei^iou oi the seal list 

Let’s fix the controller code. 


^ n n 


Oepartu(T 2 2009-U II 13:30:00 UTC 
Afmmi: 2009-u-ll 14 30 ： 00 UTC 
&estindtkm« ntthm^fsii Island 

Baggiig« a1Iow«iic«: 25.0 


Cdpi^ltys 22 



FH«hl« 

Nfljtl •: Jam^& Oorrctt 

i« 9 «a 0 «i 12 .Q 



New seat 

Name 

k$M M^ci i^rrett 

u 
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We need to replace the create method 

riit 1 exisiiny crea te mtrihtxJ in llit* cuiUrcjlI^r U cok-s iiki j tliia: 


Don 七 4 yM* dan t what AM tn 

tZ is Aoifi^ we II be rCYta6nfi| it 50* 


<ief create 

@seat = Seat - new (pai：ams [: : ：： e m ： j s 

respand_to do 

if ^M；"ucel = wa S successfuUy 咖 ’ 

— 1 { M 二二二 一 — d 

tormat-xial l render , 挪1 > u 

ilocation => @ss^t } 


elss 

format-html 

format.xml 


render action -> " 阳 W " 1 

render -> 0seat.ertors, ■ 

: status => : unprocessable^ntity 



app 


Wc need to replace this with code that creates a Seat object, 
saves the object to the database, and then i^enders a n< j w copy 
of the seat list. But what should this code look like? 



controllers 


seats controllerxb 


pencil_ 

Write a new crea l:e method that wi|] always create a Seat object 
based on the form data r ask the new object to save itself to the 

database r and render the contents of the seat list partial 





Sharpen your 
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we need 


Sharpen your pencil 
k Solution 


C'rcMx i seat objcci 

vw did 

bt^orc 

TKis allows y** ^ 

代 nde 七 he scit l li t 

jfov a\\ the scat^ 
on tKe f t 吵七 「 


Write a new create method That will always create a Seat object 
based on the form data, ask the new object to save itself to the 

database, and render the contents of the seat list partial. 


def 


M + ¥ ■ 争 《f + 


■ ■ n ir n v r a n n *r [ i! ■ ■ ■ ■ (■ ■ ■ ■ ■ ■■dim [ 讕 ■■■■*■■ 


氣屮 e «C-PoWi b 鈇 W cKcdkmj -( is 

- wtidw.. : .p#rbJ(3 J i , : A 试此:域也 f 


r + 'fa 


… Old 


So what effect does this code have? 

r]u' ttt'W cR^attr inelht>d mt'itiiH lh;U u lien llii^ Ajax ibrni ^LibmiLs a new 
IjKXjfciiig，it ^IiuLild receive ^ tic\v copy of die scat list from the server: 
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Tqst Driwo 


Suppo^ ct user goe^ to n 1 light page Lind stil>mib a new booking iL-qui^tt 


二 ^ 


fU»hU 

Mmv 卿二 _* 


■f 


f^A W.m* 

t.?i44f Ifl & SflM 1 Dtd 

n |f,4 财 ■ 

m CIW¥ £&«■ 

•n 16 .Q 

_ii_ ^aNp* it a 站 an 

lfl.Hl 



Ml esrt r ^i 


m 



The systcni works! Now when a bcM>kiiig k made ： 
the ljrows< r stays on the same page and ihc new 
booking retorxl appears immediately; 


New seat 


Cnrj* 



FBghf 

fljfL-fit Om* 

冒 wn CMufi# 

^V 4 tt u^*ty 

PldKlI# Cl 崎 

Jjmniii Gaff 攀 




NAmv IS 


ig. a 
no 


^hom 6 dlg D^.|fLrtf 




Idit D#tt/e^ 


Edit p*ii±D^ 

SACr^ 

saiLiJci^v 

*h®«mw 

hd" ijiv-mv 







New seat 


That's awesome! 

Now I can get to 
booking the other 18 
seats I need 


D 



you are her& 
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catch your 


BUliET POINTS - 

■ JavaScript can make background requests to a 
server 

■ JavaScript can use the HTML returned to update 
only part of a page. 

_ Updating the page using background requests is 
called Ajax 

■ The requests are called XML HTTP Requests 
(XHRs). 

_ Java Script can be run when eve nts occur. 


Events can be the result of user actions {like mouse 
dicks) or system events (like timers). 

If you don't Marita form to move the browser to a 
new page, you need to convert it to an Ajax form 

To make a form an Ajax tomn, you need to change 

form_fortoremotoformfor. 

The controller code that handles the form request 
can send back HTML to update the page. 

If you give the form an : up i a tie pa re meter, it will 
know where in a page to put returned HTML 


therejctre 

Dumb Que^itiQ 


m 


How come we only need to amend 
the form helpers and not all of the fields 
in the form? 

J\^l The fields in the form $tay the same 
because they fust contain data fields as 
they did before, The only real difference 
between an Ajax form and a "normal" HTML 
form, is friat ttie onsubmit event for an Ajax 
form catlB the Prototype libraries instead of 
submitting the form. Everything else remains 
the same. 

O - i saw elsewhere that Ajax forms are 
gtnerat$d by "form remote for 11 , b that 
djfferenl? 

No- form ^remote, for is just an alias 
for remote_form_for They will both do 
exactly the same thing. 


(V 

What if 1 need to convert an 
unboumd form tag? 

j\: There is an Ajax form_remote_tag that 
can be u$gd as a r^placemgnt. 

Qj i dont get it. The * form* can 
replace HTML in the -page*??? 

j\: Not quite- The form calls a JavaScript 
function to make an Ajax request. Ihs the 
Ja-vaScripl funclion that replaces th 白 HTML 
in the page. 


Qj 

When the serv&r receives the farm 
request will it still look the same? 

The request ml\ be the sarriG as 
if it had been ser>( from an HTML form. 
Prototype will construct the request so thal 
will appear to be a perfectly normal HTTP 
request, 

What HTTP method does the Ajax 
form use? 

: Just I 也 e an HTML form, the Ajax form 
uses lh^ POST method by default. 

o 

But I can chinge the method, right? 

J\[ You can change the HTTP melhod 
by providing a : method=> parameter in the 
helper. 
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A bunch of members of the Ajax Club, in full costume, are playing 
a party game, "Who am i?" Theylt give you a due. and you'll 
try !o guess who they are based on what they say. Assume they 
always tsll the truth about themselves. Fill 'm the blanks to the 
right to identify the attendees. 

Tonights attendees: 

Any of the charmmg Ajax buddies you've seen so far just 
might show up] 



Nante 

I am a library that Rails uses to generate Ajax requests 

from a browser, . . .. 

I am a language that runs inside the browser 

丨 ii n ris ■■■ I 

I am a request used in Ajax apps. and my friends call me XHR, 

9 夺 + . ■■孕 .獾 ■ + + S P ■ *S ■ 謦 + •!>!! ■ ■ 

I am an event, but I'm not a user event 

■ _ w 喔 ■■晒 ■ 

I am used to generate an Ajax form based on an object. 


I can call browser code that is registered with me. 
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ajBX fefreshei 


A bunch of members of the Ajax Club, m full costume, are playing 
a party game, "Who am I ? 11 They'JI give you a clue, and you'll 
try to guess who they are based on what they say r Assume they 
always tell the truth about themselves. Fill in the blanks to the 
right to identify the attendees. 

Tonight s attendees: 

Any of the charming Ajax buddies you've seen so far just 
might show upf 




Name 


I am a library that Rails uses to generate Ajax requests from 
a browser 

I am a language that runs inside the browser 

I am a request used in Ajax apps,, and nny friends call me XHR 

I am an event, but I'm not a user event. 

I am used to generate an Ajax form based on an object 




Ja^aStnp-t 


XML Htbp Rcqueit 

i ■ ■ p ■ q + 4 . .p ■ ■ ■ p a h. b p ■ ■ ■ 44 + P ■ a u 


System evcrii 


remote for 




I can call browser code that is registered with me, 









There's a problem with the flight bookings 


Fh * 1 badtflor party ui ^anizrr was bookiujr Ins Ijatrhclor jjiirly liip U K^n 
he hii a problem. I here was plenty of space on the fliglu wlu n he started 


I jooking seat^ but then … 



Hey r where did my last 
four bookings go? I kept 
typing in the details, but 
the bookings were lo^rt 


Q 



Someone etse was booking seats at the same time. 

Wink 1 tlit 1 Ajitx lurm tcin book sc cits UK. our simplified tonlrcjllt'!' vudv 
docm t check if' there's an error ， and k doo^it i check to see if the flight’s 
already been booked up. 

So what do vve uued to du? As wdl 沾 displaying tiie latent \ ersion of ihc 
scat list ， thr ctnitroUer code somehow need ro update ihc notices sccuon 
the page to say whether or uoi the booking was ^uccessfu]. 






This sounds straightforward, but what problem can you see with this? 








synchronous 


We only know howto update one part 
of the page at a time 

So I'at, when \vt A 've made an Ajitx rt^jLLL^l, vvt^ have alwa)s updated 
}mt one pari uf \hv page with die I1TML returned by the server: 


^ 力 j 扣 ^^ucst is 
阼 ad 吻 Ja^Se^ipf 

4 



r 

Xl 


ML frjciimenT ： 

1 J ft 

CpU^cs me 


rtTML 各七 a 
«by ^ v cr 


So what's different this time? 

I he diUVreiire this Unw is th^it we nc^ed lo updalt" llu 3 seal list wd 
ihe notices s^ciic3]i ai the Lop <if the pagtf, TliiU s l\vf> lonijilettfly 
supaiLiie pieties of [ Y\ ML Uicit nevd Ui hv placed. 

So ho\\ - ran u r t* use a single rfsp* >nse from I tie s^rv^r Lo make 
multiple cl icings to a Should vvu niakt 1 multiple rt fe quesls? Or 

send several pieces of HTML? 

There's iicLLially rrnii l i nraler Wbty of di>ing sevml oprmtions h\s 
die rcsiik of a singk' requcsL 


The trick is to send something other than HTML 
back in the response* 
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ajax 


The controller needs to return 
JavaScript instead of HTML 

II Lht J ccmLroIl^r sends HTML (.lalLi back 1* i ihe brou'sei; 
dion JaviiScripl u iJJ normally do someiliing siinplc wkh it ， 
like me it to replace par! of the page, liiu if the ci>ntro!ier 
sc nds Java Script ⑴ ck l：»ack t<' the brawsei, that code can 
dti ^ many things fhe rrmirolkr needs, il to dn 



於 Aj^ ire^esi is 

ad€ by 


Ajax request 


JavaScript m&panse 


updoteSeotListQ ： 


T^e JavaSfirifb vcsfwsc 作 

ai ? ar 


r« Wncd by ^ s^Cr 


Ji ihc figc as 


Su if tlu LOiitroIk p r wants to tipdaic ih^ list ol' seats on iJio pago. 
then display a confirmation message, then pertbrm some son 
oi fancy animaiion 1 1 s.at {wim the cm he page upside rlowtif^ ^ 

if needa Lo do js wd buck Uk' approprial^ JavaScTipt rnde. 
WhalmT is in ilie Jtiv^iStTipi will get executrd + 


l\4oic Worn iKe ^ood Ta^tc fo\\te 

ypy redly ^ 3 ^ to do 仏 is] 
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rails knows 『心 



Q 


You can let Rails write the JavaScript for you. 

II thf cuiiU^jller iu：eds lo send back Java Sl _ ript instead o\ [I IML. you 
might L\|>ect ihi\i you ^ liJ need 10 how to write JiivaSerii>i code. But 
aciualJv you don \. 

f ir 

Rails provides an object called a JavaSeript generator u'hich docs 
cxiictly w r h^\ the name suggests — it generates JavaScript 





Visual 




Hi C^r\ 


I 丨 ‘ I 

1 / I I 

m 1 


JavaScript 

Generator 


<bocL^> 

Cp^Miciii betcc-r pa.rq-TEJijpJi, 
</kkxi^> 


hc». 


It tan todt 

t^：r 


ft £如 generate Jb 

hdc and show pa^ etcii^ts. 


Hie tiling i&, that while knowing Java Script can he an atKamags.% most of tlic time, th< JavaScript coch 
you will be sending back u »tlic l^rowser will be doing some lairly standard ihings，like replacing a piec e 
nf HI "ML, or hiding part of ihe page, rjr calling some JavaSr ript liliraiy function to do an ardmadorL 
And a |a\aSrripi gnn^ralfjr fan \v} \te (he rodf lo df> each of those ihin^s R>r you. 


All you need to do is call if the right 
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ajax 



Code Magnets 

Complete the controller code to generate JavaScript to replace the 
HTML in the'notices' <div/> to say that the seat was booked. 


def create 

@seat = Seat * new tparams[ : seat]) 
render :update do || 
if 

■ ■■ iL l：H ■ n ■ ■ ■. Ut ■ a !■ E a K « ■ ■ !■ ■ ■> (U ■ B 

page, 

else 


page. 

end 

end 

end 







Seat was successfully booked 1 
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write code 



Code Magnets Solution 

Complete the controifer code to generate JavaScript to replace the 
HTML in the 'notices' <div/> to say that the seat was booked. 


def Greats 


@seat = Seat.new(params[ : seat]) 
render : update do |page I 




else 

page 

end 

end 

end 




Tlit 1 coi：lroller code." gfji itjrales }iiv r aSr ripL la Li}>ckilt: a sL'CtiLiii *A' the web 
page with kl="noticc\ So which part of the web page will that bfe? Well - 
the layout tor the flights pages contains a special output area at the top oi 
each page tor no rices, Yo i \ need to edit the I lights tayom and add an id tr^ 
ihf* <p> element like 1 this: 


<p style^ 11 color: green 11 id= 11 notice 1 ^ 
<%= flash[ : notice] %> 


VI ©ws 



layouts 


fllghts.htmf.erb 
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So what does Rails generate? 

The pageJavaSrdpt generator creates the [o 11 1 ^ v i 11 }a\ r L i Sr np l: 


■c 叶 


n 

价心 A - T %厂 
/ 


^ ^ io 


try [ 

Element - update t f, not ice H r "Seat was successfully booked' 1 ) f 

Element - update (—’seats ’、 ， ’<hl>Listing seats</hl>Nn\D<table>Vn 
<tr>\n <th>Fl ight</th>\n <th>blanie</th>\n < t h >Bagga ge< / 

th>\n </tr>\n\n\n <tr>\n <td>Brad Sturgeon</td>\n <td>22.0</ 
td>\n <td><a hreL-\ f Vseats/l\ t, >Show</a></td>\ri <tdxa href=V M / 

seats / 1 /edit\ T ， >Edit< / ax/td>\n <tdxa href=\■■/seats/l\” oncIick=\ TP if 

(confirm ( 1 Are you sure? p ) ) { var f 口 document - crsateElemerit [ 1 farm 1 ); 

r, style,display = t none 1 ; this ^ parentNode ^ appendChiId(I)^ method = 

1 POST r / fraction = this*href; var m = doctiment»createElement ( p input 1 }; 

TtK set At tribute { 1 type 1 f h h idden 1 ) / set Attribute ( f name 1 f 1 

method 1 ); nu setAt tribute(■value 1 f 1 delete 1 j t f,appendChiId(m);var 包 
=document * createElement( T Input 1 }; s .setAt tribute{ 1 type• f 『 hidden/ 

s. setftttribute(^name 1 r ^authenticity_token t ); s,setAttribute (* value* f 
l aec87b235224924109e33b3207d4e4c64207e733 , ); f.appendChild(s)/f. 
submit (3 ; ]; Eeturn false; \ ,T >DeEtroy</a ： ></td>\n </tr>\n\n <tr>\n 
<td>Kirk Avery</td>\n <td>] 5,0</td>\n <tdxa href=\ M / 

seats/2\^>Show< / a>< / 1d>\rs <Ld>ca hret^XM/seats/S/editAMAEditc/ 

ax/td>\n <tdxa href=\ f, / seats/2\ M onclick=V 1 if (confirm ( f Are 
you sure? 1 ) J ( var f = document. cre^teElement ( 1 form 1 ) f f. style * 
display = 1 riQiis 1 ; this ■ pa ireiitUodQ* appendChi Id < f) f method = 1 POST 1 ; 

f * action - this .href ;var m - docymerit .createEleirent f 1 input f ); 
m-5etAttribute{ 1 type % f hidden ”； m-setAttribute(^name 1 f i 
method 1 ) ; m. setAt tribute ( 1 value 1 , 1 delete 1 } ; f.. appendChi Id (m) ;va.r s 

=document *createElement( T input 1 ); s *setAttribute( 1 type 1 t f hidden ”； 
s-setAttribute < ^narne * f ■authenticity token f ); s.setAttrlbute( f value 1 r 


This wiU he re[nrned to ihe browser ulien the x\jax booking (arm is 
suhniiil r "d tc* thf 1 rontroljpi; Prt'vioiisly; ih<- brn^ser would takr *he 

f>r Lhc: cDnlroIltT reKptmKe and tist 1 il Uj rcf^hire sonit , pari 1.1! the 
page. Bit 110vs ； \\v waiit iht_ Ihjwsilt tt) exMd^ till 1 mjxmse. We want it lo 
mn our generated JavaScript, 


But how do we tell the farm to execute the 
JavaScript response? 





are we 


If you don't say where to put the response, 
it will be executed 

Let’s look at ihe Embedded I tuby cock* rliRt generates the Ajax (ormi 


<% reinote^form^forUeat, i update^ 1 seats 
〈％; f ^ error messages 

<%= f*hidden 一 field 
<p> 

<%= f,label : name 
<%; f-text field 


: flight 一 id %> 

%><br / > 

: name %> 


</p> 

I <P> 

<%= f*label : baggage %><br /> 
<%- f.text field : baggage l> 


</p> 

<P> 

<%= f.submit ^create" %> 
</p> 

<% end %> 


This {odf fc r re at ps ^il! of the 1 JavaSrripl ihafs nereftHnry m lire off an 
Ajfix l et^uesL when [lie Jbrm's l>uLLon is j^Tssefi 丁 he Ibi m tht^ii 

Uiko Lever is f4jLurm , i! by the server iiind u^cs ii tu rx.phu.u Liu. pEirt 
of tJic page labeled with id = fc scafe'. 

Now thiil vviis fine wlieii the server was seiitlliig HTML back Lo Uie 
bru\vs(.T B Bui now ifs strndiiigjiivafSurip[ Lind \w dtm'L U tiiit die tbrni 
to put that jiisi anywhere. We want it lo execute it ? and * hiifs a very 
deal. 


The changic vvi- ariually need to nmkc tn the p?igo template k vt ry timaii. 
All \ve iifecl lo do to make (he form execute the code k remove the 


update parameter; 


<% remote form for(seat) do IfI 


J\ic ^ 6 a {£ fara^eici- ha^ 
teen verftoved* 
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^^-Tqst Driwq 


Now, wlumi 听 : is Ixiok^d, llui form di^pluys n surc^ss or iliilun 3 nitrn 妒 



But the page dot^ii t update tlic seal list. Wc need 
10 generatf extra Java Sc rip r tr> update the seal W^L 



Sharpen your pencil 




Vou need to write an extra call to update the seat list with the 
contents of the appropriate partial. 


page* rep 1 ace_html 
: locals -> 


partial —> 
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test 




^rpen your pencil 
k Solution 


You need to write an extra call lo update the seat list with the 
contents of the appropriate partial 

This >jf|| 

arc ^adrci^ 、 partial 


paga, replace—html 
: locals => { 


) 

scats , 


scSft^ 


:partial => 1 1 ^ 

~> @scart ^liqhticats } 

B ■ i -fe ■ ■ ■• n- ■ ■ ■ # + v ■ i # 4 i I; f> «V-3 #«nkvr4_Hir #A4B 




TKea^iHr 


The completed code can will 
now do several things 

Hen’s whaE llu_ fomplfLrd code should h n>k likt-: 



def create 


§seat = Seat.new(params[ : seat]) 
render : update do |page! 
if dseat.save 

page.replace _html ■notice r ， 
else 

page . r*^p 1 ace_html ■ notict：- 1 j 

end 

page,repiace_html 1 seats*, : partial => 1 f 1 ights/seat_IIst V f 

* LoC^ls { t SS3.tS — ^ @SS3.C- & (SS-'CS \ 

end 

end __ 


1 Seat wais successfully booked 1 
1 Sorry - the seat could not be booked 


Ue tan i；all methods on the page JavaScript gcncriitor 
often we like. So iJ the- si?ai is saved correctly^ the page 
objffct will generate code fo updates the notice and it creates 
JavaScript lo update ihe seat IhL 


304 ChBDtBf 7 





















bjbx 



Nnw when a new sent is btHiked s tiol only does the COiififrnjiticm message appe+tr s but ihe 
seat Ebt gets updated ttxj ： 



The system goes li\ e a]id people are able to quickly book 
multiple 



you are here 


Head Ftrat 


^Lounge ： 

nTHrctiin^fStj island 


Multiple mean^ multipfe stags in 
my bar.*, better get some more rum in! 
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rails 



Tools for your Rails Toolbox 


You’ve got Chapter 7 under your 
belt, and now youVe added the 
ability to add Ajax to your applications. 


SS: 工二 > 


^ …“ 妒 广 _ d \ I k 

丁一 身二 1 

如 — :二:;一冗二—一 一 

W _ -- 

j 洳？，办 II 
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8 XML and multiple representcitions 

It all looks ^ 

different now... 


You can’t please everyone all of the time. Or can you? 

So far we’ve looked at how you can use Rails to quickly and easily develop web 
apps that perfectly fit one set of requirements. But what do you do when other 
requirements come along? What should you do if some people want basic web 
pages, others want a Google mashup, and yet more want your app available as 
an RSS feed? In this chapter you’ll create multiple representations of the same 
basic data, giving you the maximum flexibility with minimum effort. 



this is a new chapter 
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user-centered design 


Climbing all over the world 

Head First Climbers is a web site for mountaineers all over the world. 
Climbers report back from expeditions to record the locations and times 
of mountains they have climbed, and also to report dangerous features 
they’ve discovered, like rock slides and avalanches. 

The information is obviously very important for the safety of other 
climbers, and many climbers use mobile phones and GPS receivers to 
read and record information straight from the rock face. Used in the 
right way, the system will save lives and yet — somehow — the web site’s 
not getting a lot of traffic. 



So why isn't it popular? 

The application is very basic. It’s simply a scaffolded version 
of this data structure: 


Incident 

mountain 

string 

latitude 

decimal 

longitude 

decimal 

when 

datetime 

title 

string 

description 

text 


id 

mountain 

latitude 

longitude 

when 

title 

description 

1 

Mount Rushless 

63.04348055... 

-150.993963... 

2009-11-21 11:… 

Rock slide 

Rubble on the ... 

2 

Mount Rushless 

63.07805277... 

-150.977869... 

2009-11-21 17:… 

Hidden crev... 

Ice layer cove... 

3 

Mount Lotopaxo 

-0.683975 

-78.4365055... 

2009-06-07 12:… 

Ascent 

Living only on... 

4 

High Kanuklima 

\ ^ - -- - - 

11.123925 

- - - -- 

72.72135833 … 

产 -__ 

2009-05-12 18:… 

— —_ 

Altitude si... 

- - - - 

Overcome by th... 


As you’ve noticed by now, scaffolding is a great way to start an application, 
but you’ll almost always need to modify the code to change the generic 
scaffolding code into something that’s more appropriate for the problems 
your users are trying to solve. 

So what needs to change about this application? 







Create a scaffolded application 
that matches this data structure. 
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xml and multiple representations 


The users hate the interface! 

It doesn’t take too long to find out why the web site isn’t popular: the 

user interface. 

The system is used to manage spatial data — it records incidents that 
happen at particular places and times around the world. The location 
information is recorded using two numbers: 


The latitude. This is how far North or South the location is. 

The longitude. This is a measure of how far West or East a location is 


The users can record their data OK: they just read the latitude and 
longitude from GPS receivers. But they have a lot of trouble reading 
and interpreting the information from other climbers. 




I*m sure that dangerous 
rock slide is supposed to 
be some place near here... 


O o 


So people can add data to the application, but they can’t understand 
the data they get from it. That’s cutting the number of visitors, and the 
fewer visitors there are the less information is getting added... which 
causes even less people to use the app. It’s a real downward spiral. 

Something needs to be done or the web site will 
lose so much business it has to close down. 





Think about the data that the application needs to display. How would 
you display the information? What would be the best format to make 
the information easily comprehensible for the climbers who need it? 
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map location data 


The data needs to be oh a map. 


The system records geographic data and it should be displayed on a map. 

The correct data is being stored, and the basic functions (create, read, 
update, and delete) are all available. The problem is presentation. The 
location is stored as two numbers — the latitude and longitude — but that 
doesn’t mean it has to be displayed that way. 

Instead of seeing this... 



...climbers need to see something like this: 



|hdidcr»is ： sKow 

r?|^| j c"| |妇 I 言 j K*tif ： //lodalKos-t ： 3000/i>r»tidch-ts/l 


I iKliHki, k lifenHi 

!■ 


Now this is obviously going to be a pretty big change to the interface, 
so the web site guys have decided that rather than change the whole 
application, they are going to run a small pilot project to create a version 
of the page that displays an incident and get it to display a map. But they 
have no idea what to do, and need your help. 

What’s the first thing YOU would do? 
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xml and multiple representations 


Wc need to create a new action 

We don’t want to change the existing code — we only want to add to it. 
Until we are sure that the new interface works, we don’t want to upset 
any of the existing users. After all, there aren’t that many left... 

So we’ll add a new action called show_with_map. At the moment, 
someone can see one of the incidents using a URL like this: 

http :// localhost : 3000/incidents/1 


We’ll create a new version of the page at: 


http :// localhost : 3000/incidents/map/1 


This way, the pilot users only need to add / map to get the new version 
of the page. We’ll use this for the route: 

map.connect 'incidents/map/:id', : action=>'show_with_map 





' , : controller=>'incidents 


f 



We can create the page template by copying the app/views/ 
incidents/show. html. erb file. What will the new file be called? 


The incidents controller will need a new method to read the appropriate Incident model object and store it 
in an instance variable called @incident. Write the new method below: 
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test your new action 


(^Sharpen your pencil 

Solution 



te the page template by copying the app/views/ 
incidents/show. html. erb file. What will the new file be called? 


The incidents controller will need a new method to read the appropriate Incident model object and store it 
in an instance variable called ©incident. Write the new method below: 

.sV>ov/_y/*it^af is the .. 

y>amc o( *ti^C ad*tiov\. — l^didc^*t-f mdfpav-ar»\sC ： id3) This Will be 七 H 

..-TV*om t-hc IAI\U. 


The new action seems to work... 

If you now look at the two versions of the incidents page, we see that they 
both display the correct data. What do you notice? 


fills! 



伞 




Incidents: show 


G V + 


http://local host:3000/i incidents/1 


Mountain: M^unt RuRhl 齣 rk 
latitudes 6 S.CW 34 a 055 ! 535 H 
iLQU^tEUlle^ - lSD.^39fa3HBKA«9 
Wtmr \2 2iX»- Ll-31 13=£E=P0 UTC 
TlClti Rflck slide 

D'escrfiptlan;： ftubtalin qh thtt linden rumbledj and just rnir.rird 
Edit I BfrEk 



Create the page template and 
the new controller method now. 


TW»s »s 
staWoldcd 


This vcvsioh has a URL. 



Incidents: show 一 with map 


I 


http://localhost: 3000/i incidents/map/1 

【久， gwigfa 



VC ^S sh ow 

the s 3 ^c dais. 



Mountain ： M&unt Ru^hlf^r; 

Latitude: 

Largltudii! 

^P\ Wfieni ZOM-11-21 11:55:00 UTC 
TttJhS ： Rjock silds 

Rubtric on the lietfge tu^nbleil., frtl^cd 

Bit I B 4 Ch 


TV^IS "is i\\t version 
七七 ^alls r\c>M 

siiov/ w\ 3 P 

— ■ - • 

ad*tior\. 


Both versions of the incidents page look identical — and that’s a problem. 
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xml and multiple representations 


The new page needs a map... that's the point! 


But of course we don’t want the new version of the page to look the same. We 
want to add a map. 

So how will we do that? There’s no way we’re going to build our own mapping 
system. Instead we’ll create a mashup. A mashup is a web application that 
integrates data and services from other places on the web. 

Most of the mapping services allow you to embed maps inside your own web 
application, but we’ll use the one provided by Google. Google Maps give you 
a lot of flexibility. Not only can you embed a map in a web page, but you can 
also, without too much work, add your own data onto the map and program 
how the user interacts with the map and data. 

Here’s a high-level view of how it will work: 



The map will be displayed at the approximate location of the recorded incident, 
and a symbol mark the exact point. 

The Head First Climbers application will generate the code to call the map, and 
the data to display on it, but the map itself, and the bulk of the code that allows 
the user to do things like drag the map or zoom in and out, will come from the 
Google Maps server. Even though Google will provide the bulk of the code, we 
still need to provide two things: 


The HTML and JavaScript to call the map. This will be a little complex, 
so we will put the HTML and JavaScript we need in a separate partial 
that we can call from our page template. 

The data we need to display on the map. To begin with we will use an 
example data file to make sure the map’s working. 





•tv Head W 

CWmbcvs sewev. 



"The dories 
from the ^oo^le 

/Waps SCV-VCV-. 


So what will the map code look like? 
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get your google key 


So what code do we weed? 


We need to have the following code in a partial called —map • html. erb: 



命 

►DawnJaaJ If! 


<% 


"""ryrioiAAAAnfs7bKE82qgb3Zc2YyS-oBT2yXp_ 

fuTT^e-U 二 ^lse ^ 


show 一 action I 1= nil 
new 一 action I I= nil 
data M = nil 


This key wkes wo 

4 ‘ Wa w p 


%> 

<div id. = "map 

align= n right n 

style= n border : lpx solid #979797 

m in-width: 400px; 

if full—page _%> 

min-height: 800px; 

height: 800px; 
else -%> 

min-height: 400px; 


<% 


<% 


<% 


height : 400px; 
end _%> 

background-color: #FFFFFF ( 

border: lpx solid #999999 
padding ： 10px;"></ dlV> 


There’s not enough space to 
display all of the partial code here, 
but you can download the file at 
http://tinyurl.com/hfrailsmap 


So what does this code do? First of all it calls some JavaScript on the 
Google Maps server that will generate a map on the web page. The map 
will have all of the basic drag and zoom functions built in. 

But the basic Google code doesn’t do everything we need. It doesn’t load 
and display any of our local data. So the code in the —map • html. erb 
partial also loads location data from a file, which it uses to move the map 
to the correct place and display an icon at a given point. 

But there’s a little complication with the code... 


□ 


app 


views 



incidents 

_map.html.erb 


314 Chapter 8 















xml and multiple representations 


The code will only work for local host 


Google places a restriction on the use of the code. They 
insist that you say which host you’re going to use it on. That 
means before you can use it on www.yourowndomain.com, 
you need to tell Google about it. In order to make sure 
that people comply with this condition, the code will only 
run if you provide it with a Google Maps key. The key 
is generated for a particular host name, and if you try to 
embed a Google map into a page coming from anywhere 
else, the map will refuse to run. 

But for now, there’s not a problem. The 一 map • html. erb 
partial we’re going to use has the Google Maps key for 
localhost — so as long as you run the code on your own 
machine it will be fine. But remember, you’ll need to apply 
for your own key before running the code anywhere else. 



If you want to embed Google Maps in your 
own web apps, you need to sign up with 
Google. To do this, visit the following URL: 
http://tinyurl.com/mapreg 



You need to include the map partial in the show_with_map . html. erb 
template. We need to pass a local variable called data containing the path 
to the map data. We’ll use a test file for this at /test. xml. 


Write the code to call the partial. 
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send data to google 



rpen your pencil 
Solution 




You need to include the map partial in the show_with_map . html. erb 
template. We need to pass a local variable called data containing the path 
to the map data. We’ll use a test file for this at /test. xml. 

Write the code to call the partial. 


<%— reader 6pa\rtial—> map ) ： lodals—> {: data—> / }) %> 


Now we need the map data 

Before we can try out the embedded map, we need to provide 
it with map data. To begin with we will just use the test.xml 
test file. This is what it looks like: 



public 


4 


test.xml 



\^dA If! 


To save you typing in the long 
numbers, you can download the 
test.xml file from 
http://tinyurl.com/maptest 


^escr.pt.on^xsan example desc rl pt 10 n</de 
<latitude>63.0434805555556 latitude 〉 

<longitude>-150.993963888889</longxtude> 

<title>Test Data</title> 

</data> 


iption> 


The mapping data provides the latitude and longitude of the 
test incident. When the Google map loads, our map partial 
will pass it the contents of this file and the incident should be 
displayed and centered. 
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xml and multiple representations 


So what happens if we go to a URL like: 

http :// localhost : 3000/incidents/map/1 



The map works! But what if we go to a different URL? 



Every map looks exactly the same, regardless of the data. That’s because each 
map is using the same data: the contents of the test.xml file. 


In order to make the map display the location of a given 
incident, we need to generate a data file for each page. 
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generate your xml 


What do we need to gcwcrate? 

We’re passing XML data to the map, and the XML data describes the 
location of a single incident. The location is given by the latitude, the 
longitude, the title, and the description. We need to generate XML like 
this for each incident. 

So the system will work something like this: 



-ii f|ji 

r\ 


H 4 - 1 c TT * J "i 5 




TV^c ^oo^lc 
asks -fov- 

data -Pile -fov- 


j tuvvcr\*b md'«dcir\t 


— 个 - — 

T / 

工 hc ”P displays 

i h i hc ^ 


</incident> 


TV>C sevvev ^cv>cvatcs 
tV>c /ML kor 

av>d 代 U 於比 . 


If this is starting to feel familiar, good! The Google Map is actually using 
Ajax to work. Remember how we used Ajax to download new version of 
the seat list in the previous chapter? In the same way, the Google Map 
will request XML data for the location of an incident. 

So the next thing is to generate the data. Where will 
we get the data from? 
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Well generate XML from the model 

The data for the generated XML will come from the Incident model. 
We’ll be using just four of the attributes, the latitude, longitude, title, 
and description. 



But how do we generate the XML? In a way, this is a little like 
generating a web page. After all, XML and HTML are very similar. 
And just as web pages contain data from the model, our XML files will 
also contain data from the model. 

So one option would be to create a page template containing XML 
tags instead of HTML tags: 



app 





_ show_with_map.html.erb 

We dould a pay *tcmpla*tc spc6-f*idally *to pwb 

data. But should wc? 


1 


999 ? 


That way would work, but there’s a better way... 
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let your model generate xml 


A model object can gcwcrate XML 

Model objects contain data. XML files contain data. So it 
kind of makes sense that model objects can generate XML 
versions of themselves. Each model object has a method 
to—xml that returns an XML string: 


TW«s is 





The 一 method 
wWyTah /MU s 七 — 

<incident> 


參 • • 


</incident> ’ 

个 

/MU s 七 — 


@incident.to xml 



"Uc to 一， I 

sirmo^ 7cyrcscrsb^ *b^c model object. 


But creating the XML is only half the story. The other half 
is returning that XML to the browser. We’re not using a page 
template, so the whole job will have to be handled by the 
controller rendering the XML... 
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What will the controller code look like 

We can amend the show_with_map method to output the XML: 


This is ^ obje^-t 

wc al … dy … di4 

TV rtv\dtr wrbW 


def show— with 一 map 

@incident = Incident.find(params[ : id]) 


render : text=>@incident. to_xml ~.TWis y/ill 七 e 扣 s*br’’ 

— dcsdv-'ibcs {\\t *m6dcn*t object- 


end 


丁工 Cfa 二 


The render method returns the XML to the browser. We’ve seen the 
render method before, but this is a slightly different version. Most of 
the time you use render to generate a web page from a template or 
partial. But you can also just pass it a string object — and that’s what 
we’re doing here. 



Gee| 


To make your life simpler, the Rails folks 
also allow you to pass a parameter to 
the render method called : xml 


render : xml=>@incident 



Dumb Quest! 


9 ns 


Remind me, what does the render method do again? 


render generates a response for the browser. When 
your browser asks for a page, that’s a request, render 
generates what gets sent back. 


If the render method is passed an 
object using the : xml parameter, it will 
call the to_xml method on the object 
and send that back to the browser. The 
: xml version of the render command 
will generate the same content as the 
render command in our controller, 
but it will also set the mime-type of 
the response to text/xml. But for now, 
we will use the : text version above. 
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Tqst DriVq 


So what do we get now if we go to: 

http :// localhost : 3000/incidents/map/1 



Source of: http://localhost:3000/mcidents/map/l 

<7xml versi oji" ir l. 0 n encodings"UTF~B "?> 

<iaeideat> 

■c-ereated-at typc■ r datetIme 11 >2003-lL-2lTll i 31Z/created-at^ 

< do a cl' ip L ion>-Rubblc ； on the ledge -tumbled # and juatr missed us . </de ； scrip Lioa>- 
<id type* 111 intcgc£ ,r >l</i5> 

<la 七 itude types "deoijmal 1 ,043 dS0*S55555^</lstitude> 

clongitude type*"decimal >-150,953963889flE9</longiiudc> 

<mo irniain>Mon nt Rushless</mountain> 

<title>Rock 3lide</title> 

<updated-at. type■ r datetime ">2009-11-2 ITl 1 1 59 ! 3lZ</updaied-a j b> 

<whcMi type= " date time" >200 9-11-21X11 i 55:00 Z< / when> 
incidents 





The controller is now returning XML containing the data from the 
incident object with id = 1. 

But is there a problem? The XML we’re generating looks sort of the same 
as the example XML, but there are a few differences: 




We’re generating too many attributes. The 
example data file only contained information 
about the latitude, longitude, title, and 
description. But this piece of XML contains 
everything about an incident, even the date and 
time that the incident record was created. 

The root of the XML file has the wrong name. 
The generated XML takes its root name from the 
variable we were using, 〈 incident〉. But we 
need the XML to have a root named <data>. 


<data> 

<description>This is an example 

description</ description 〉 

<latitude>63.0434805555556 </latitude> 

<longitude>-150.993963888889</longxtude> 

<title>Test Data</title> 



The XML is almost in the right format, but not quite. 


We need to modify the XML that to xml produces. 
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Code Magnets 

The to_xml method has some optional parameters that let us 
modify the XML that it returns. See if you can work out what the 
values of the parameters should be: 


def show— with 一 map 

@incident = Incident.find(params[ : id]) 
render : text=>@incident.to xml( 


=>[ 




end 
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modify the xml 



Code Magnets Solution 

The to—xml method has some optional parameters that let us 
modify the XML that it returns. See if you can work out what the 
values of the parameters should be: 


def show with map 


@incident = Incident.find(params[ : id]) 


render : text=>@incident.to xml( 


only 


root 




: title 


description 


end 



ED 


「” changpe^jl 


reader • 七以七二 〉... 

ta 一如。十 ^ 切- 







tKereiar 

Dumb 


e no o 

Questi9ns 




Shouldn't we generate the XML in the model? 


You could, but it's not a good idea. You may need to generate different XML in different situations. If you 
added code to the model for each of those XML formats, the model would quickly become overloaded. 
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Tesr DriVq 


Now when we go to: 

http :// localhost : 3000/incidents/map/1 


we get XML that looks a little different. 



You’ve managed to modify the XML so that it only displays the data we 
need and has a properly named root element. It looks a lot closer to the 
example XML file. 

The to_xml method doesn’t allow you to make a lot of changes to the 
XML it produces, but it’s good enough for most purposes... including 
sending the XML to Google for some custom mapping. 

With very little work, to_xml gave us exactly the XML 
we wanted. 
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climbers need websites, too 


Meanwhile at 20,000 feet 






Some people on the pilot program have a problem. 

The web pages have disappeared! Before the last amendment a URL like: 

http :// localhost : 3000/incidents/map/I 

generated a web page. The trouble is, now that URL just returns XML, 
instead of a nice Google map. 


before your latest changes: 



BcW 此 w a 广 cb 


After ypur latest changes: 


R O^j 







X/l/IL. 




Source of; http://localhost:3000/incidents/map/1 

tmcLuiins?- 11 UTF- 8 11 7> 


r ~5 


vi 

<J：oscriptl&a>Itubblc on the ledge tumbled H ar.d juat miasicd un. </^CBCtiptiea> 
^lutitudu 14 det:imal">63.04^4AQ<5S55556</iiititudu> 

clongitnde type= "decinial l, ^-iS0. 196iflS6ft9^/Iitudo 

<titlc>Re>ck a iidic < / 

</dato> 
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Wc need to gcwcrate XML a^id HTML 

The show_with_map action originally generated a web page with 
the show_with_map . html. erb page template. But once we 
added a render call to the controller method, Rails ignored the 
template and just generated the XML: 

def show— with 一 map 

@incident = Incident.find(params[ : id]) 



Of course, that makes sense, because there’s no way an action can 
generate XML and HTML at the same time. 

But we still need a web page to display the map, and the map still 
needs XML map data. So what do we do? 

We need some way of calling the controller in one 
way to generate HTML, and calling the controller in 
another way to generate XML. 
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multiple representations 


7 


m 



Generating XML and 
HTML should be easy. We just 
create another action. 


Mark: Another action? 

Bob: Sure. One to generate XML and another to generate HTML. 
Laura: Well that’s not a great idea. 

Bob: Why not? 

Laura: That would mean duplicating code. Both methods would 
have code to read an incident object. 

Bob: Whatever. It’s only one line. 

Laura: Well now it is. But what if we change things in the future? 

Mark: You mean like if the model changes? 

Laura: Or if it we get the data from somewhere else, like a web 
service. 

Bob: It’s not such a big deal. Let’s worry about the problems we 
have right now, okay? 

Mark: I don’t know. Laura, what would you do? 

Laura: Simple. I’d pass a parameter to the action. Tell it what 
format we want. 


Mark: That might work. 

Bob: Gome on, too much work. 

Laura: Less work than creating another action. 
Mark: But one thing... 

Laura: Yes? 


Mark: Doesn’t the URL identify the information we want? 

Laura: So? 


Mark: Shouldn’t we use the same URL for both formats? 
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XML and HTML are just rgpresgwtatiows 

Although the HTML and XML look very different, they are really visual 
representations of the same thing. Both the HTML web page and the XML 
map data are both describing the same Incident object data. That incident 
is the core data, and it’s sometimes called the resource. 

A resource is the data being presented by the web page. And the web page 
is called a representation of the resource. Take an Incident object as an 
example. The Incident object is the resource. The incident web page and 
the map data XML file are both representations of the resource. 


Wcv-c s -the mcsouv-Cc. 


mountain 

latituc 


.tude 


◎incident 



when | 

— 

| titlO 

r 


des 


££ipti 


on 





same vcsouvtc 
has 


V 



Thinking about the web as a set of resources and representations is 
part of a design architecture called REST. REST is the architecture 
of Rails. And the more RESTful your application is, the better it will 
run on Rails. 

But how does this help us? Well, to be strictly RESTful, both the XML 
data and the web page should have the same URL (Uniform Resource 
Locator) because they both represent the same resource. Something 
like this: 

http : //localhost:3000/incidents/maps / 1 

But to simplify things, we can compromise the REST design (a little 
bit) and use these URLs for the two representations: 

http : //localhost: 3000/incidents/maps/1.xml URL \rcW ⑽栋 c data; 

http : //localhost: 3000/incidents/maps/1.html °^ cv " HTML- 
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choose your own format 


How should we decide which format to use? 


If we add an extra route that includes the format in the path: 

map.connect 'incidents/map/ : id.:format', : action=>'show—with—map', 

: controller=>' incidents' ^-- - - , 

we will be able to read the requested format from the XML and then ^ 七 ^ 灼 s 、 ovv 

make decisions in the code like this: 


if params[ : format] 


'html' 


叫 // V 池 如 匕人 


Generate the HTML representation 



^p//hU| 


else 


Generate the XML representation 


This y/i 

\y\ : -fov-ma*t -field- 


^11 be s*tov-cd 


end 




But that’s not how most Rails applications choose the format to generate. 
Instead they call a method called respond_to do and an object called 

a responder: 


respond—to do 
format. html 


I format | C 。扪 “ Vcs ? o,d^ ob〆. 

{ ^TV,e dode -to _ 七 …― ” 。CS 

- 


V^cvc- 


format. xml { 

- <r-Thc toAt -to ihe X/^IL 9 o« 


end 


This code does more or less the same thing. The format object is 
a responder. A responder can decide whether or not to run code, 
dependent upon the format required by the request. So if the user asks 
for HTML, the code above will run the code passed to format. html. 
If the user asks for XML, the responder will run the code passed to 
format. xml. 

So why don’t Rails programmers just use an if statement? After all, 
wouldn’t that be simpler code? Well, the responder has hidden 
powers. For example, it sets the mime type of the response. The 
mime type tells the browser what data-type the response is. In general, 
it is much better practice to use respond—to do to decide what 
representation format to generate. 
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ExeftclSe 


The show_with_map method in the controller needs to choose whether it should generate 
XML or HTML. Write a new version of the method that uses a responder to generate the correct 
representation. 

Hint: If you need to generate HTML, other than reading a model object, what else does the 
controller need to do? 


The show—with—map • html. erb page template currently calls the map partial and passes it the / test. xml 
file. What will the partial call look like if it is going to call the generated XML file? 
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respondjto do the right thing 


學 

Sotptian 




The show_with_map method in the controller needs to choose whether it should generate 
XML or HTML. Write a new version of the method that uses a responder to generate the the 
correct representation. 

Hint: If you need to generate HTML, other than reading a model object, what else does the 
controller need to do? 


_L leave Ka»is to . . ... . .r. 

tall ⑶ *t 二 

—K …一 I ^0,0?* do 

. 七 :!! {. 


sV^ov/^J^r 


Wc 63^ leave tw»s - Ka.l 

▲all 诈七 ㈣ 上必 … 


\rci^dc\r : *tcx.*t =1 >@mdidlc^*t *to %n\\( 


:\ro 。 七二 


c^d 

end 


The show—with—map • html. erb page template currently calls the map partial and passes it the / test. xml 
file. What will the partial call look like if it is going to call the generated XML file? 


<7pir. . v : a .:!?A 外 9(! 如 



Dumb Quest! 


9 ns 


Q/ If the format.html section doesn't need any code, can we just skip it? 


No. You still need to include format.html, or Rails won’t realize that it needs 
to respond to requests for HTML output. 
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If we look at the XML version of the page at: 

http :// localhost : 3000/incidents/map/1.xml 

we get an XML version of the incident: 






——— .. - —— —，— — — — ■ 


你 ■ w. 


So what about the HTML version: 


匕 alhos 七 : 多 U/maf/l ivtml 








j.. e 


Pltar- 3%， 


u 








It works. Now different incidents show different maps. But before we 
replace the live version of the code, we better make sure we understand 
exactly how the code works. 


So what really went on here? 
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which format gets requested? 


How does the map page work? 

Let’s take a deeper look at what just happened and how the HTML page 
is rendered. 



The controller spots that an HTML page is needed. 

The browser points to the HTML version of the page. The controller realizes 

that HTML rather than XML is required, and so calls 

show with map . html. erb. HTML is sent back to the client browser. 





show_with_map.html.erb 




JavaScript requests the Google Map. 

JavaScript within the web page requests map data from the Google Maps 
server. The Google Maps server returns it. 



^oo^le Map 
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JavaScript requests the incident XML. 

JavaScript within the page requests XML for the incident from the 
controller. It then displays it on the map. 



<data> 

</data> 




You say that a resource should 
always have the same URL Why is that? 

It doesn’t have to, but REST—Rails’ 
main design principle—says it should. 

But if the format is in the URL, 
doesn’t that mean that different URLs are 
used for the same resource? 

Yes, sure does. Adding the format to 
the URL compromises the RESTfulness of 
the design... a little bit. But it’s a common 
trick. It’s simple, and works well. 

So there’s no way to use the same 
URL for different formats? 

There is a way to do it. If the request 
contains an “Accepts:” header say—for 
example—that the request is for “text/xml ”， 
the responder will run the code for the XML 
format. 


Is there a way of listing the 
attributes you don J t want to include in 
to—xml output? 

Yes. Instead of using the : only 
parameter, you can use the : except 
parameter. Rails is remarkably consistent 
and you will found several places where calls 
in Rails have optional : only parameters. 
In all cases you can switch them for 
: except parameters to say which things 
you don't want. 

Is there some way that the 
controller can tell the difference between 
an Ajax request from JavaScript and a 
browser request? 

Sort of. The expression 
request. xhr ? usually returns ‘true’ for 
Ajax requests and ‘false’ for simple browser 
requests. The problem is that while it works 
for the requests generated by the Prototype 
library, it doesn’t work with a//Ajax libraries. 


Why do I have to call render 
sometimes and not others? 

If you are happy to run the default 
template (the one whose name matches the 
action), you can omit the render call. 

You say that the generated 
XML and the HTML are different 
representations, but they don’t contain 
the same information, do they? 

That’s true—they don’t. The XML 
generated for a single incident contains 
a smaller amount of data than the HTML 
representation. But they both present 
information about the same resource, so 
they are both representations of the same 
thing. 
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let’s get some climbers climbing 


The code is ready to go live 


Our new version of the location page works well, so let’s replace the 
scaffolded show action with the show with map code. 


o 


Remove the routes. 

We created custom routes for the test code, so we 
need to remove them from the routes.rb file: 



config 
routes, rb 


v-id *t^csc Imcs. 


ActionController::Routing::Routes.draw do |map| 

map. oonnoo 矣 ~~' inoidonto/map/ : id ' —: action - > * ohow_w 1 th__map *-7 : controllcr™> ' 1: 

map. oonnoofe ~~' inoidonto/map/ ; id. ; format T , — : action™> 1 ohow_with_map '―,— . contrc/ll^r—> ' me j. clouts 

map .resources : incidents 



o 


Rename the show—with—map method in 
the controller. 

show_with_map is going to become our new 
show method. So delete the existing show method 
and rename show with map to show. 



g inci 


Then rename the show—with—map.html • 
erb template. 

That means we need to delete the existing 
show. html. erb and replace it with the 
show_with_map . html. erb template. 


□ 


app 




incidents—controller.rb 

如 do^ollcv, 州 aw 

as sV^oY/. 


views 

□ incidents 

show.html.erb 








s 


3h0w with mQp.html. orb 


D 


tKeretar 

)umb 


e no o 

Questions 


If the route disappeared, how did 
the right format get chosen? 

The map.resource route sets up a 
whole set of routes. These routes all include 
the format. 


How come the index page went 
to “/incidents/1 ” instead of “/incidents/1, 
html ”？ How did Rails know it was going 
to be HTML? 

If the format isn’t given, Rails assumes 
HTML... which we used to our advantage. 


What does map.resources mean? 

That generates the standard set of 
routes used by scaffolding. 
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Tesr DriVq 


Now the the mapped pages have replaced the default 
“show” action. So now the main index page links to the 
mapping pages, not the text versions. 



ppirvlmd 

Dwn-nfriB ； 
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L 小： 
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科 o p 


Incidents: index 


- http://localhost:3000/incidents/ 


Listing Incidents 






CVwrnr ， nivppn. 


■w i£unlcpw9 Ihv -imirC 


s 冷冰 H^iniWi 
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IfH^iddvnprvirAn* 
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1 






C^-Oail 


VK! 


SH pB P 






KMC! 


1 HiJuntain:i^ghJta : 

I ^CTm^TTTTTTii 


One thing though - isn’t that index page 
kind of... boring? Especially compared to 
all those nice visual map pages! 
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improve the index page 



E%enciSe 


The users have asked if the index page can display a whole set of all the incidents that have 
been recorded, and fortunately the — map • html. erb partial can generate multiple points if 
it is given the correct XML data. 


This is the existing index method in the incidents controller. Rewrite the method to generate 
XML from the array of all incidents. You only need to change the root element to “data”. 


def index 

@incidents = 工 ncident•find (: all) 

respond—to do |format| 

format.html # index.html.erb 
format.xml { render : xml => Qincidents } 
end 
end 


a 

a PP 


□ controllers 



incidents—controller.rb 
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xml and multiple representations 


The index page will need to include a map. Write the code to insert the map at the given point. 
You will need to pass the path of the XML version of the index page as data for the map. 


<hl>Listing incidents</hl> 

<table> 

<tr> 

<th>Mountain</th> 

<th>Latitude</th> 

<th>Longitude</th> 

<th>When</th> 

<th>Title</th> 

<th>Description</th> 

</tr> 

<% for incident in @incidents %> 

<tr> 

<tdx%=h incident .mountain %></ td> 

<tdx%=h incident. latitude %></ td> 

<tdx%=h incident. longitude %></ td> 

<tdx%=h incident. when %></ td> 

<tdx%=h incident. title %></ td> 

<tdx%=h incident. description %></ td> 

<td><%= link_to 'Show ', incident %></ td> 

<td><%= link_to 'Edit', edit_incident_path(incident) %></ td> 
<td><%= link_to 'Destroy', incident, : confirm => 'Are you sure ?', 
: method => : delete %></ td> 

</tr> 

<% end %> 

</table> 


<br / > 

<%= link_to 'New incident ', new_incident_path %> 



app 





views 



incidents 





index.html.erb 
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map your arrays 



ExenciSe 
S^LsitlOH 


The users have asked if the index page can display a whole set of all the incidents that have 
been recorded and fortunately the —map • html. erb partial can generate multiple points if 
it is given the correct XML data. 


This is the existing index method in the incidents controller. Rewrite the method to generate 
XML from the array of all incidents. You only need to change the root element to “data”. 


def index 

@incidents = 工 ncident•find (: all) 

respond—to do |format| 

format.html # index.html.erb 
format.xml { render : xml => Qincidents } 
end 
end 


dc-f mdcx. 


— (: all) 




•fovma 七 html 养 


•fo\rmat'll { 




} 




end 


P 


app 


□ controllers 
I 〉 I 司 incidents—controller.rb 
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xml and multiple representations 


The index page will need to include a map. Write the code to insert the map at the given point. 
You will need to pass the path of the XML version of the index page as data for the map. 


<hl>Listing incidents</hl> 

<table> 

<tr> 

<th>Mountain</th> 

<th>Latitude</th> 

<th>Longitude</th> 

<th>When</th> 

<th>Title</th> 

<th>Description</th> 

</tr> 

<% for incident in @incidents %> 

<tr> 

<tdx%=h incident .mountain %></ td> 

<tdx%=h incident. latitude %></ td> 

<tdx%=h incident. longitude %></ td> 

<tdx%=h incident. when %></ td> 

<tdx%=h incident. title %></ td> 

<tdx%=h incident. description %></ td> 

<td><%= link_to 'Show ', incident %></ td> 

<td><%= link_to 'Edit', edit_incident_path(incident) %></ td> 
<td><%= link_to 'Destroy', incident, : confirm => 1 Are you sure ?', 
: method => : delete %></ td> 

</tr> 

<% end %> 

</table> 


<%二 (: partial 二 ： lodals—> {: da*ta—>V*m^idc^*b.>cml w }) %> 

<br / > 

<%= link_to 'New incident *, new_incident_path %> 



app 




P 


views 




□ 




incidents 

index.html.erb 
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a very graphical index 


Tqst DriVq 


Now when users go to the front page, they see the incidents in 
a list and on the map. When an incident is clicked, the details 
are displayed, as well as a link to the incident’s own page. 


科 p n 




AH J the ih^idchis 
how Micd oh ihc • 
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xml and multiple representations 


Hey, there s so much data now! Td 
really like to know about the incidents 
that have been posted in the last 24 
hours. How about a news feed? 



provide RSS news feeds to provide easy 
links to the main resources on a site. 


But what does an RSS news feed look like? 


you are here ► 


343 




rss is just xml 


RSS feeds are just XML 

This is what an RSS feed file would look like for the climbing site: 



This is just an XML file. If you use an RSS news reader, or if your 
browser can subscribe to RSS news feeds, they will download a file just 
like this, which contains a list of links and descriptions to news stories. 

So how can WE generate an RSS feed like this? 





Do any of the tags in the RSS look particularly surprising or 
unclear? What do you think channel does? What about link? 
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xml and multiple representations 


Well create aw action called news 

Let’s create a new route as follows: 

map.connect '/incidents/news', : action=>'news 1 , : controller :〉 1 incidents', : format=>'xml 


Write the controller method for the new action. It needs to find 
all incidents with updated_at in the last 24 hours. It should 
then render the default XML by calling to—xml on the array of 
matching incidents. 

Hint: The Ruby expression Time . now. yesterday returns a 
date-time value from exactly 24 hours ago. 


r^lj^rpen your pencil 
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render your rss 



rpen your pencil 
Solution 


Write the controller method for the new action. It needs to find 
all incidents with updated_at in the last 24 hours. It should 
then render the default XML by calling to_xml on the array of 
matching incidents. 

Hint: The Ruby expression Time . now. yesterday returns a 
date-time value from exactly 24 hours ago. 


dc-f ricv/s 

v-c^dcv :>cm| 二 >@m6dcirrb 




)U touia ^avc also used 心 % 七二 >@rn 以⑼ U 匕一 wl. 
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xml and multiple representations 



Tqst DriVQ 


This is the XML that is generated by the news action: 


BOO 


MudIU FircJuw 


r~> 



This XML h]c d«5 not appear Ed have any style- intorniatLon assoct^tcd with it. Ilic docuincnE iroc is shown 
bebw. 


一 ^iiicidenls ljfpe= "array > 

- <lncSdent> 

■^creited-at lyp€-"da6clLme>200S-11-2 IT 11 :59 :31 Z<^reated-at> 
<descrSpTion>Rubbk ： on the ledge Tumbled, and Just missed ua.</descriplloK> 
type= n mtc|cr>l ^/id^ 

(IsiliEude typdied mul h WS A</l]iiilm3,r_> 

<lonj>itude lyp*- ^ccLtnal' 1 ^ 150.9939633S 8B3?</lonftitude> 

<ith]u nLjim>M 4 M 3 nL Run.h liss^</m-iiuni£iin> 

^lilte>Rock £3idc</Eill«^ 

<npdsii^-bil ty|H ： = H ElulE：l M -2 IT 31 : \ Z^mpdu iwi-ja l> 

<wheiv lvp«- datcUmc r >2009 - 11-2 i T L l: 55:00Z</when> 

- <liicident> 

<rr¥a 【《 d-at iy|w="ElnlL'1imje M >2IK)it-11 -2 IT ] 2 : E]Ii:52Z</c:riisib*rl-aL> 

- <descrSpiion> 

loc Layer covcnng crevasse. LaslB^nky to the dements. 

Dong 


We’ve generated XML for the correct data, but it’s not the sort of XML we need for 
an RSS news feed. That’s OK though, we had that problem before. When we were 
generating XML data for the location data it was in the wrong format, and we were 
able to adjust it then. 

We just need to modify this XML in the same way... don’t we? 



Rcwcwbcv- - tW»s >s 
^c^^evidevi so 

*,^dc^U 』 —7 

aweav A 此 

ioCCh mod»^*cd ^ 

七 last 2^ V^ouvs 





Is there a problem converting the XML to match the structure of the RSS news feed? 
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take control of your xml 


Wc have to change the structure of the XML 


The to—xml method allows us to make a few simple changes to the 
XML it produces. We can swap names and choose which data items to 
include. But will it give us enough power to turn the XML we have into 
the XML we want? 


TWis 




< ?xm l version="1.0" encoding="UTF-8"?> 

〈incidents type= n array n > 

〈 incident 〉 ” >? 008 -ll_ 21 Tll: 59 •• 31 Z</created-at> 

— type rr te n = rz 七_丄喊 ㈤ ]姐肌 ssed 

<description>Rubble on th 

<id type-^nteger">l</id>^ ⑷娜 555556</latitude> 

<latitUde type-'decxma • 993963 888889</longitude> 

<longitude type^Mecxmal >- 150 . 9 ⑽ 

<mountain>Mount Rushless</mountaxn> 

<title>Rock slide</title> 

<rss version 二 ”2.0 n > 

<channel> 

<title>Head First Climbers News</title> 

<link>htt P ://localhost: 3000 /incidents/</link> 

<item> 

: ：；：； I ：：： I ；：：： rr：e ledge tumbl e . and , USt ml sse d … > 

<link>htt P ://localhost:3000/incidents/l</link> 

</item> 

<item> 


IW.S *.s Y/ht W 


Wc need more XML POWER 

The news feed XML can’t be generated by the to_xml method. While 
to_xml can modify XML output slightly, it can’t radically change XML 
structure. For instance, to_xml can’t move elements between levels. It 
can’t group elements within other elements. to_xml is designed to be 
quick and easy to use, but that also makes it a bit inflexible. 


For true XML power，we need something more. 
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xml and multiple representations 


So well use a new kind of template: 
an XML builder 

If we created another HTML page template, we could generate whatever 
XML output we like. After all, HTML is similar to XML: 




<rss version="2.0 n > 

<channel> 

<title>Head First Climbers News</title> 

<link>htt P ://localhost:3000/incidents/</link> 

<% for incident in @incidents 
<item> 

<title><%= h incident.title %></title> 

<descri P tion><%= h incident. description %></descri P tion> 



But Rails provides a special type of template that is specifically designed to 
generate XML; it’s called an XML Builder Template. 


XML Builders live in the same directory as page templates, and they are 
used in a similar way. If someone has requested an XML response (by 
adding .xml to the end of the URL), the controller only needs to read the 
data from the model, and Rails will automatically call the XML builder 
template. That means we can lose a line from the news action: 


This is )> , 

XL CW ^Od 


def news [ 

Qincidents = 工 ncident•find (: all, : conditions=>[ ' updated_at^> ? *, Time.now.yesterday]) 

L 亡丄丄 der : xml-> Qincidcnto - 


end 


This code will now just read the data from the model and the XML bulder 
template will do the rest. 


So what does an XML builder look like? 


□ 


app 




□ Vie 


Pay 

(^tr\Cr 


a-tcs 

a-tc 


X 亂 builds 
ic^f?lsi cs 

3 ⑽咖 X 亂 




incidents 只丁象 


show.html.erb 


news.xml.builder 
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xml builders 



Page templates are designed to look like HTML files with a little Ruby 
sprinkled in. XML builders are different. They are pure Ruby but are 
designed to have a structure similar to XML. For example, this: 


xml.sentence( : language=>'English ') { 

for word in @words do 
xml.word(word) 
end 


might generate something that looks like this: 

〈sentence language="English">' 
<word>XML</word> 
<word>Builders</word> 

<word>Kick</word> _ 

<word>Ass!</word> 

</sentence> 




So why did the Rails folks make a different kind of template? Why 
doesn’t XML Builder work just like a Page Template? Why doesn’t it 
use Embedded Ruby? 

Even though XML and HTML are very similar — and in the case of 
XHTML, they are technically equal — the ways in which people use 
HTML and XML are subtly different. 



Web pages usually contain a lot of HTML markup to make the page 
look nice, and just a little data from the database. 



Most of the content of the XML, on the other hand, is likely to come 
from the data and conditional logic and far less from the XML markup. 


Using Ruby — instead of XML 一 as the main language, makes XML 
Builders more concise and easier to maintain. 
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xml and multiple representations 




aa] Puzzjc 


Your job is to take code snippets from 
the pool and place them into the 
blank lines in the code. You may 
not use the same snippet more 
than once, and you won’t need 
to use all the snippets. Your goal 
is to complete the XML builder 
template that will generate RSS. 


app 



views 


_J ,nc, 


incidents 


xml.channel { 

xml.title( ) 

xml. link (’’http : //localhost:3000/incidents /’▼) 
for incident in 
xml.item { 

xml. (incident.title) 

. ( . ) 

xml.link("http :/ /localhost:3000/incidents/#{ 



news.xml.builder 


}▼▼) 


Note: each thing from 
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use an xml template 



Paa] puzzjc ^alufiaii 

Your job is to take code snippets from 
the pool and place them into the 
blank lines in the code. You may 
not use the same snippet more 
than once, and you won’t need 
to use all the snippets. Your goal 
is to complete the XML builder 
template that will generate RSS. 


app 



views 


^ 1 inci 


incidents 




: version = > n 2• 0 

xml.channe 
xml.title( 

xml.link("http :// localhost : 3000/incidents/ 
for incident in 
xml. it< 

xml. I title ■( incident .title) 



news.xml.builder 



1 xml•description | 

( 

• • • . 

incident.description 1 ) 

xml.link("http :// 

localhost : 30 00/inc ldents"/ # { jinciden^^dj 


}") 




352 Chapter 8 












































xml and multiple representations 


Now let's add the feed to the pages 

But how will users find the feed? Browsers sense the presence of a news 
feed by looking for a <link. . . / > reference within a page. 



views 


The folks at Head First Climbers want the news feed to appear on every 〉 

page, so we will add a reference to the RSS feed in the incidents 
layout file, using the auto_discovery_link helper: 



layouts 
靈 incidents.html.erb 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN 

"http://www.w3.org/TR/xhtmll/DTD/xhtmll-transitional.dtd"> 

<html xmlns= n http : //www.w3.org/1999/xhtml n xml : lang= M en n lang-"en > 
<head> 

Cmeta http-equiv="content-type" content^"text/html;charset=UTF-8 M /> 
<title>Incidents : <%= controller.action—name %></title> 

<%= stylesheet—link—tag 1 scaffold ， ％> 

<%= auto 一 discovery 一 link 一 tag (: rss' {:action=>'news '})%〉 

</head> 

<body> 

<p s tyle="color : green M ><%= flash[ : notice] %></p> 

<%= yield %> 

</body> 

</html> 


This should create a link like this: 

<link href 二 "http://localhost:3000/incidents/news.xml" 

rel="alternate" title= n RSS" type= n application/rss+xml" / > 

But to see if it works, we need to fire up our 
web browser again. 
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rss, anyone? 




Tesr DriVq 


Now, when a user goes to the web site, an RSS feed icon 
appears in their browser: 


Di-Pfcirch't bv*owscv~s 

have di-Pfcvcht 

o*f show'rn^ 


Ann 


Intidenri ： ndex 



g : 蠢 


htl [» /IDlKI/irer^lFm^.i' 


Hounliln 

Mqyfit 


firm 

In^idcnU: ihcfu __ ，/ L 

l“ 丨 e 丨圔 

匕 

[0 hfipr//l«xlh^pj!3POO/i^M#nEfX 



65.0^ 




Listing incidents 


Longitude 


Mauiibiln Latitude 
Mgunt 


Rju^hicxi isfi . 祀如挪咖 me 


And if they subscribe to the feed, or simply read it, they 
will see links to incidents that have been posted in the 
previous 24 hours. 


O O O li^Ml Fir^t CNrfifrcrah Nrm 

^ I j J C I y . + J 1 1 f«Eri.hLLp.^ WK ： a , hgs-t !H)0C/lnEhlcn4&/ncwv.nrnl 


Head First Climbers News 


Hock *l<d€i 

RuDQla'Qfi m* oinvhM. dru iuu m Rma 



- - ^ —— tAm 


* : cn- 


Hidden cr^vngsii 

ton'Inynr Kivnnng crnvnisn Lo_ai1 Kinky to Bmiu Inn rS H <；id W “ 

AftCfrnl --y 

Lnlng flnlf pn dr>Hf chcknn pio^p^ «m njfnptalnd gv« 4 di^._ ' >.■ i -| fiWC 


Altitude glekne&ft 

by sr« IbcK QriixygiHi. *« iban^ar>M m« *ec»k,, Htaoriore,. 


4 Total 


SMFCil AlIkZiH. 
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Ow top of the world! 


xml and multiple representations 


One of the first news items on the web site is posted by our intrepid 
climber, and thousands of climbers hear of the good news. 



I made it! Tm at 
the top! Hooray! 






rails toolbox 



Tools for your Rails Toolbox 

You’ve got Chapter 8 under your 
belt, and now you’ve added the 
lility to use XML to represent your 
pages in multiple ways. 




_ 丁 oo\s 一 〆 '。 卞 

，扣扣 s 加一⑽咖 

“产 r 

:一撕 ; :气: ;二 

r^ , 心 sw\. “⑽七 Y 

1 \ 扒 W ㈣ r 

，卜丄一 … d 如 

一： :一 :一工 W \ 扒 
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9 REST and 々职 





it's time to consolidate your mash-up skills. 

So far you ve seen haw you can ： add Google Maps to your web apps to clearly show 
spatial data But what if you want to extend the functionality that’s already there? Keep 
reading, and well show you how you can add more advanced Ajax gooctness to your 
mash-ups, And what’s more, youMI learn a bit more about REST along the way 
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iandstide i "■ 

Too many incidents ! 


With ilir imprmrcl ustT iiHerlhre' i hr munher of visiiors to ilu- 

I ; irsl Climbers late |w soajed + Tile imublt 1 is. rnam iwidfnh mi being 



1([liai lliiiTL. ton iirnny Ibr pn fp\v U? i L ： : tsiJ\ rml tliroii 


I here are so many w 
incidents! 1 need to 
scroll past them all to get 
to the map, and thafs 
trrcky while I'm hanging. 


The index pa^e of the site displays the information In 
two ways. 


O 

o 


Ai (he lop nf tlir jniLre is it delailctl list ol in ， .idmb with latiliKl^s i\nd 
km^iiude^. The troLtbk 1 is, lots of people scroll past this to got to the map at 
the end (jJ the page. I 

inridenU YUv pi.nhlt j ni \\t k rr is nr^i ； il| ihc data is sliown on llie ump. 


Neither of these are entirety It’s liard ro locate the incklents 

ih iin il)r Hsu rUid llial 、 wh) wv adrk s d a m ； tp. Rui (1 it 1 n,i 叩 diM j sii i di ， sj>la^ 
all of i\w ckiUi :l\ iiilahlt k . Su whni Hhiuild \vr 〔 h>: J 
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rest ajax 


The wap could show more details 

Thf J iI Ndiulinn woidd bi j io naaks* [h<* m：»p r/n m(fn\ If it c^cmld l>c 

rhanged in display mort* ust-ll.il iulismmlion :ibout (Jr- incidr'iila, w? 
t i VLild pro!jiibJy just n L ino\ r \hv tlic [isl cj| ijit.idruls ;liicJ make Li m limit 
page mu: hig multi-Umctipnal map. l hai would mean wr wouldn't 
to go to separate pages in order to enter more data, for example* 



V* Wd & 七 he 的 

wC bi^ ㈣ 


1 litre's jusl "m* pruhkni: 11n.? nuip piu tiaJ wus dotmilouded, Ifsi shiipli^ 
piioiigli to im ， bin should we renlly change the code? Formnately ? tliere^ 
a devdopmcnl technique the map partial uses that means we dbn，t need 
hs … mil t|]t j flfJWrilQadfxl code But wl i；li is il? 



費办 IM 


How do you think we could go about making changes to 
the map without changing the downloaded code? 
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google maps 


We can extend the map using Ajax 


Vhv pec?pwho thc j map partial [itjy>i s ri Lhai piietty soou petjple 

would vvajil to i a xl( s nd the wiiy ihe map worked. And h£ j caiise lh( s map 
fjiirtial calls Gouglr Maps, and C{k>^1c Maps is buih usin^ ii rriiide 
sense that the way to extend the map h with ： Ajax, 


At the moment, (he map worb by making 
a request back to the ^i^er asking lor an 
XML Hie remaining tlif 3 defaik o\ all of the 
n l i >11 n tiimeeri n ^ i n rideTi Is ret:<jrd^d <m tht 5 
syjiit?m. By tirlkiilL itie map tlispliiys Lhe title iuid 
dost rip tion contiiiuod in the XML. 

But【he map pariial also allows y<m tu pas^ it 
(lie name of aji action that will display the 
informarioii fiir an indderM- .And thai arrion t an 
be wluiLt a w ， i- \\iiE !ikt\ so if you vou r<mld 

|T # f r |r 

generate ^onit'lliinn t] iai luokril like Lht* * kri^inal 
\ er^ion of the incident show page. 


叫 httd ie, 


d ■中 ay ttm o^i^ui i h £ hc 

Oh ihe 



We nv.t'd ilif pfjp ¥ hLm1 - erb parliiij to iTiakt- 1 .Ajax r^qut'siSj so 
this iticans it wil\ nt:t p d Lircess to the Prototype library Wl 1 </aji 
this in die same way vve did bclbre, i'jy adding a i^frrcnce to the 
javaScript liljraiy bi the layout file like this: 



app 


P ^ I views 


UQ] layouts 



stylesheet—link_tag _ scaffold 1 %> 
auto_discQvery_link_tag( : rss, { : action^>■news■}> 

javascript_inctag 1 prototype r %> 


incidents. htmLerb 


%> 


</head> 
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rest ajax 


Pot how do we convert the index page? 

Flit 5 firsi ihin^ we iu rks 10 rh^ii£>'e tlu a ihmi pagf is [he 

□f incidents i^ud m^ke the Tn£ip larger ： 



^edio the list ^ Wid— 


Wfe fyted "t® fr^dke 'way big 0 C^r- 


VW also nt a ^d tci id I the map p^irlial iht' £)1 the action ihcil will 

dis|jluy ilw inridrnl in for million, TIuli's tjuik* a fvw changes, but ii will 
actually make the index * html, erb template w lut simpler [lutn iL 
was before' 

In faci, thi^ is aJI u'e'Il be Jell with: 

This we wilt i Ijv^Clr 

mif f ill "tKe fijC- 


app 



views 


<hl>Listing ineidents</hl> 

<%^ render (: partial ^ 1 W , : locals^>{ : data->Vincidents,xml 

: full_page^>true r : 3how_action => 1 show 1 }} %> 

<br /> 



link to ，New incident 1 ^ new_incidentjpath %> 




^11 incidents 

fndex.html.erb 



When ihc map partiaJ k called like this, it changes» its buhavior. 
Bdbi't% \vhen an incidcnl was dickjed, the partial raa a pirceuf default 
JavaScript iha\ displayed file ikh and descrip dan in the jwi>up 
informalicsii window, i\ Faking ihis Hian^ means thai wb^Ti an iuddent 
is t lirk^ii oil lilt 1 ni ： ip, ilw piirtial rails ilie show iirlion and disphiyn the 
ac lion’s response it] the vviiiduw- 


故 W 沪■吒长 邮 di— 社 e 
attiw to Mncrjtc ^ to« 校士 

& ( iht Wfydo^ 


Or at least it wifi, once we make the show action 
generate the correct oytput^ 


you BfB hBfB ► 361 






























show 


What will the "show" action need to generate? 


We already have a show action s and this generates <x web 
piigt? ctmlaiTiini; ih^ Lkmilw uf an inrid^iis and a rnap、vith 
die incideni'ii locaiion-, 

Hut thal s imy more llicin we need rum: Hie show action 
only rii'fds in gtmu ‘ iliv Icxl do tails uf mi incideiiL ^urI 
because the infoi itmtion h going to be displayed next to a 
point on a map, vv^ won' t need lu display the Luimdr and 
longitude either 

l lie re’s one other thing tliafs diilcrcm: we only need a 
page Fragment, We 6o\ri want the standard H I NIL 
holler pl^fe that will be produced by a page tanpfat^ Sn this 
means our action will need to generated From a partial 
LemplaLe, We ll i.all Lhis show. h tml, erb. 



A»i need 



Sharpen your pencil 


Complete the line in the "show 41 method of the controller to cb \1 
the _show,htmLerb partial： 

app 


controllers 



def show 


0 incident = Incident, find(params [ : id]) 
respond_to do | format | 
format - html i 



tncidente controlier.rb 


+ + 


■ + »• i -a ■ 


} 

format, nml { 

render : text=>@incident,to_ 

: only=>[ : latitude, : longitude, : title^ : description]^ 


root=>"data 1 


} 

end 


end 
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rest ajax 



CoJe Magnets 


Complete the cod 旮 for the new _show.htmI.efb partial,. Rem&mber 
you won t need to display all of the information. 


<p> 


views 


<b> 


<%«?h 


</b> 


%> 


</p> 



Incid^nte 


show,html,erb 


<p> 


<b> 


<%=h 


</b> 


%> 


</p> 


<p> 


<b> 


</b> 


<%—h 


%> 


</p> 


<p> 


<b> 


</b> 


<%-h 


%> 


</P> 



' ILjT nlj| |T here p 
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solving 


Sharpen your pencil 
W Solution 


Complete the line in the "show'"method of the controtSer to call 
the _showJitml erh partial: 



app 


def show 



controllers 


@incident - Incident < find{params[ : id]) 

reapond__to do | format | 

render : partial 二 >’ show: ■ Iod^!s^>{■ ihdid.e»vtm t\ tii} 


霞 


incidents controller.fb 


+ 9> b t * ' 


format . 

render : text—>Sincident - to xml ( 


only=>[ : latitude, : longitude r : title f : description] 
root=> 1> data M ) 


} 

end 


end 
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rest ajax 


/ 


I — 


Code Magnets Solution 

Complete the code for the new _^how,htmLerb partial. Remember 
you won't need to display all of the information. 


app 


<P> 


vlew& 


<b> 



</b> 



%> 



incidents 

show.html.erb 


</p> 


<p> 



%> 


</p> 


<P> 


<b> 


<%—h 


</p> 



</b> 


incident, de script 




%> 





incident,latitude 


you are here ► 
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hurrah for 




Tost Drivo 


Now ii wc go akmg V i the index page, slut enough — the Usr of iiicideim 
has disapp^aiTd and llie map is mudi larger, Bui more important is what 
happens when ihe uiwt rlirksi on one. of i\w inridents an the map; 





W hen ihe map Jelects a mouse click 01 i an incident k ^norates mi Ajiix 
request to the show action, and thk generates Ur ‘ dctaUi in HTML tor llu 
incicfeat. llie map receives ihr H 1 ML and uses it to replace rhe content 
ol tJie incident、in format ion wiiidrm: lliis then gets displayed to ihe user, 

Chapter 9 
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The new map funeitonality is a success! 

l'\]v nvw mup rLHictiuiifJilv its ( p uLlLiisbistirMlly h\ ihedimlm 

I 1 1 <*y no Ic m^vr [m! I" srmU pwt i* l<m 玷 lisl ot nicictoils U) to tlu: 

map. Now tlic\ ran idi tlio intormah<^n \h< \ twcl diroci lb mi (lie 
map J h< jusi rme thing— 



If onJy 工 could enter 
new incidents on the 
map itsdf, rather than go 
through q \\ these pages.,. 


Ciimbers want to report new incidents 
using the map. 

1 h 〜 nm list- UPS imiis lo lliul tlit h ir lalhi 士 :iml 
ion^tud^ And fype ilmi iiL but l!k p ^iiv \vouJd hv a lot 
nier tor tlicm if thry rould simply plot a poult on 
(he nic-ip and (ill in flir uihrr detiillN ngU\ rheThai 
uuiiUI lii.ikr Jnl.i-rnli v l”i i\\r \ ]in^n-r>. 


So how do^s entering data on 
the map compare with what 
we’re currently doing? 




request asynciironousfy 


We need to create requests using Ajax, too 

H stmKHJiif waiits to neale a nvw iiic idenl repoi i, thciy ruriL j nd> Imve tu 
tlmjugh the follow big steps: 





O 


Click on the New Inefd^rit link on th6 front page. 

You can t enter data directly on the fmit page, you need to tbll^>w a link 
to the “new” page instead + 


ihe fi^k -to Ck-eiir 


kaKimpmtt^wr$.^jmm 


Ll Sitlmi 


J ^idehi 





Many at I y enter the latitude and longitude on the New page, 

ThtTe’s no map on this so you iic^nfd lt> enter die kuilutk , find 

longitude manualJy and save the record. 
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o 


rest : nd ajax 


The incident youVe created is displayed. 

Once you've clicked on the save bimon. von'tT to the cnt^lown E£ show v， 
* ^ ■ 

page we\'e just created. And if you need to create a second incident or 
RtM bac k to ih^ main map. you ncM^d lo Iiei die back hui.ton a rouple of 
Lirritfs to Oie franl r>iige where you, begin all over agciin. 



So what weeds to change? 

RliIIut ih^in |r<i Lhrcuigli all t hes e 11 it* iisrrs wan! I in L^rface 
io lie nnich simpler. 1 lit'V just Wcinl ixt t lick on die map and 1111 iu Lliu 
details using a ibrm in the pop-up wiiidow. 



I h make that rhan^% wr- nee'rt U) Hif 1 “m i 'v “ torm using Ajax- 

We alsu need the niiip io call iJir fontl when st>mt s oiu fc i: licks on a new 
ApoL But J ki w? 


vou erre tiere 
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one render 


actions 


The inap partial lets us specify a 
"new" action 


So [Ur \\v\v looker] al shtn\iu^ iiw iiit ideiH d^laik mi lilt 1 imip. 
But hovv do we go about creating new iiicidems： 1 

Thr map. h Lm 1 , erb par[ia] lets us spt j c ify an ailion to 
Jmiidle nev'i mcidents, in ihc sLiinL' way it lets ns specify tin 
a^cbn lor ^Lowing inctdeiu dc-Uuls. l\m means t】uu we emi 
add a “iiew” aclion ta the index* htm 丄 ， erb file like ihis: 


app 


views 



incidents 


(ndex.htfnl.erb 


<hl>Listing incidents</hl> 

<%= render partial^'map 1 , ： loc^ls-> {: data=>»Vincidents-xml", 

: full_page=>true, ^ho W _actian=>^howS : ]) 




link to 1 Heif ing 


喊 Ve 切 

\p ate a 




new 


If sonicune clicks a new spot on the map, tlic _map - html - erb will 
create a new marker and pop up an information wifido'v containing 
whaiever is returned by thr “neu ,,% action. 

We already have a “new’ action deiined for the applicatioiii, but it's 
generating a full web page. Rather than dkpby a ltd] web p^gc 7 we 
neerl the ^new" jirrion to rreaie a ]r^ fVagmnit that will bf* displayed 
inside the pop-up inlbrnialion windf>w. Also, we nrt'd la makt* suit th?il 
lieii lIr 1 ListT 汾 uhmhs “new" lirrnu it sL^y.s an iht. map. 

So we'H create m partial cailed _new.html,erb that 
generates an Ajax form. 
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rest 


ajax 



You need to create a _new.html.erb partial for the form. Complete the code for the form. 
Remember - people wont need to enter values for the latitude end longitude, but the form will 
still need to record them. _ 


When the map calls the "new 11 action ( it sends the location of the new incident as request parameters. Complete the 
code in the incidents.cointrallerrb new method so that it calls th& partial correcliy: 

format.html { 

app 



you are were 
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adjust the w a/kv 



You need (o create a _new.htmLerb partial for the form. Complete the code for the form. 
Remember ， people won't need to enter values for the latitude and longitude, but the form will 
still need to record them. 


teitaSe 


<%— +.Ijbc1 <%二 fTictd : motirdbsih 

</p> 

… 《r ... . ■…■…■■… b reto'f 

» ii ++?« 1."^+ ，■ 

<%二 field { 饮购一七。叫 fi 

i ■申 + !■ F ■丨 + t ¥ W+ -TTTV^ " j — - h S -i -I + i i 4 t p jj-s f + i » +> Rri+ + +B4+-EI*l«l+-fc 1 i 鬵 d9++F9*l + FBfr + +E 


•aa^+hE'l + B 


%二石 Ubd : 七 Ale %> <%二 f ■ 七 ^ t ^it\d %> 


When the map calls the "new" action is sends the location of the new incident as request parameters. Compfete Ihe 
code m the incidents_conitrol!er.rb new method so that it calls the partial correctly: 

format,html { r*L _ 

app 


@incident, latitude^params [ F latitude 1 ] 
@ incident, longitude=params t 1 longitude 
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rest ajax 




Tssr Drii/q 


Now if a user to iIk. irnrn page and clicks on a fresh point on 
the map, ihey rail enter details for the incifleni using'a pop-up form, 
When t\w 4 (Irease" hiition h rlirkf d，Uie iV>rm remains <m the srreen h 
but A ne：vv rt,t「urd is displayed on Lh^ datuba^t*. 






id 

mountain 

latitude 

longitude 

when 

title 

description 



Mount 

63.G434SD55 … 

-150.993 & 63, + * 

2003-11-21 11: … 

Rock slide 

Rubble an th^ 

1 … 

o 

Mount Rushlesa 

63.Q7805277... 

■I50.977G69... 

200D-11-21 17: … 

Hidden crev..„ 

Ice layer co/ 

0 . 圈 ■ 

3 

Mount Lotopaxo 

-0.603575 

78■4365055 … 

■: _7 丄二 ：… 

Ascent 

Living only/c 

m,., 

4 

High Kanukllma 

U.123925 

72.72135G33 B .. 

2Q09-05-12 ie :… 

Altij. Lude si . . a 

ov&rcome . 


So is everytliing OK? 


you are h^re ► 
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confusion is 10 e 



Wait a minute - what gives? 
I keep hittfng the "create 1 ' 
button but nothing happens! 


The climbers are confused. 

Even thou^li [\w. lbrni u r urks Hne ;md iric'iclenl-JH ar^ b^ii^ Sdivt'd [he 
databcise, it autualiy hoLs like noliiiiig liappcniii^ WIicii the user f licks 
on the "Create" but con, there's, no Iccdback indicating the rccoi'tl was 
saved. I his means that the users are repeatedly hitting the Create button, 
and rhe database 1 is starting to get lots of duplicate reroixis. 

Sonic thing needs to be done. Back in the old days when ju^i had 
scalTnlding, when 4 user reported an hiddent with the "new" pag<\ rh^ 
bnju'stT woiild imiTiedialely swilrli Lo ihe k 、 h<m ■ T his r<inliruied 

lliat liie ihiVA wlis sav^d to tJuf daUibasC 4 . 



« 

h - j jH fl. 

* j- 


■■■■■ 


KCLp 


New incident 


IPTMliniS 


JSi 




TVie or^irLSl 


■4' 


fs n n 

I 乂卜 1 i ^A 

■' m M .11 ■■ J ，- - i. II. 


Incidents: show 





L sWv /，？ 呼饧 t>ic 



Mount 籲 In: Nowrn Hub 

LdtKydv 

y>ngttyitip 
WKen: tom 

她：如 


lid# 

0#Bcriptiovu nubbin i 
Edi£ 


Could we have something like that in the Ajax app? 


nanti 
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rest ajax 


How do we PROVE an incident was saved? 

Tin: sVHlem really needs to shuu the- rn^U a d 【 ec"id in r!pop-up windov\ 
mmg tlx- “dicjvv’. aclbn. So if someone enters deiaiJ> of M] uiddent. tlie 
pop，up should change to hIiow a rmd-only \ r ei^ion c>f the inddeni. 



That way, (lie pop-uj> inibrmation window will work likt a litlle 
brcawsei; forwarding to the new informalion. Except of course, our 
(ode riin' L j ual fonv^ird iht* hro'vMT to the new in formation. We need tci 
keep €iiTnbt fc ni on the siunv pugc … j l 1st wiili nvw iNfojTriLitnui ^houing. 



隹 vr 


The Ajax form needs to be replaced with the contents of the "show'' action 
for the incident. How do you think you could do that? 


you 3f£ here 
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in-pface /aie^ 

The form needs to update the contents of 
the pop-up's <div> 

Evt?n Lhuu^h it h>oks Atm like a desktop iipplimkHs ， Cioogle Mlij >s 
basically boiJs down to just HI ML and Ja\ aSa ipt. It's ju&i i\ web page. 
That meam that i!k l pfip-up inlormiidon window- and rverytJiing 
eke — are just pieces of K J ML 

The contents ot the pop-up wi 【 ido、v arc cli fined in a <div> demeat 
with: 


id = 1 map 一 inf o 11 

Hi is h iniporumt I leraus^ we’re using an Ajax lorm io trnk* a new 
iricidL'Til fcpottj and Ajeix forms〔ail bt 1 List'd In dynamically Lipdale piurtii 
of a web page using th«ir ids' 



So il we elm yc 1 ! Lht 1 lo update ilw map in fo <d 1 v> with ihe* 
cuilients of thr “'how” aclion for llie bicidenl, il should 办乂 . ihv mci h i1k p 
feedback thev need* 

w 
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rest id ajax 



Sharpen your pencil 


app 



views 



new.htmLerb 


<% remote form for(incident 


This is part of the code for the "new 1 " form. Bearing In mind that 
the form will need to update th 它 page with the form response, 
complete the code ： 




<p> 


<%» f,label : mountain %> <%* f + text fieId : mountain %> 


</p> 


The "new 1 " form submits itself to the 'create 1 action.This is the 
create method on the controller. Mark any changes you think 
are needed, 

def create 



@incident « Incident, new (params [ : incident]) 


respond 一 to do tformat| 
if @incident.save 

flash[ : notice] — T Incident was success£ully created . 1 
format.html { redirectto(@incid0nt) } 

format.xml { render : xml => @incident^ ;status —> : created^ 
: location => @incident } 

else 

format .html { render : action => ,! new r, } 
format.xml { render : xml => @incident,errors t 
: status —> : unprocessable_entity } 

end 

end 

end 
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nothing 



Sharpen your pencil 

Solution 


This is part of the code for the 1 "new ，; fonru Bearing in mind that 
the form will need to update the page with the form response, 
complete the code: 





rest -i ： ajax 




Tsst Drivo 



So now what happeiis when the u^r creates an incidents 

Clicking on a new point on the map displays the Ajax torjust iikc before: 


fim when I hey hit rhe “Crcatf’’ bution, nor only dors tJie system ^ave 

the r^forci lo I lie dat^bast^ it ab 。 rtHunt.s a jiage Iragmpnl ronUiinii^g 
llie inikJenl ddiii 、 wliit:h [he Ajax form nxnv uses Lo updaLc llie 
map Inf o <div> imitk. the pop-up window. 



!p _ jl -1 . lJ-Np 
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no dumb 




tl^ere|are no 

iSimb Questions 


0 ： What happens if the user’s browser doesn't have 
JavaScript enabled? 

A- ^ application map won't run. Ajax applicatiofis, like 
Google Maps, require JavaScript- 

Qj If Google Maps h an Ajax application, how come 
we didn't have to include the Prototype library in the last 
chapter? 

J\l Google Maps calls all of its own AjaK libraries from the 
Google servers, so it doesn't need the Prototype library. 

(L: So why do we have to pull the Prototype library in 
this time? 

J\l If you pass action names to the map partial, the partial will 
need to make Ajax requests to the server For that it needs the 
Prototype library … independent of what Google Maps is doing. 

Qj Is there a way of making the application wark without 
the map if $omeone 3 disabled JavaScript? 


/ I still don t get how respond to works. IT format, 
titml is some kind of method call, how come there's code 
between {^} following it? 

j\: In Ruby, mettiods can accept pieces of code between 
U.} (or do...end) as parameters. So the code between { and 
I is passed for format.htmi, and tl decides whether or not to run 


How does the map partial work? 


Its not that com pi rented, but it's mosOy JavaScript, so we 
don't get into much detail here. You couid check oul Head First 
JavaScript for a lot more on Ihose sorb of details. Ihough! 


Q ： But I really want to know how it works! 


Ifs worth looking through frie map html erb file If you 
mnl to know more about JavaScript did m mention, Head First 
JavaScript is a great book : 


A, 

You couid if you modified your controller. The controller 


decides which views to display, so it could wu different 
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rest i ajax 


Aval 綱 he! 

So \\n w/vv allmvt.d ⑽ morr LlcLiilctJ iilli>i]m“>n on llir 
niap 5 and ids 。 c^cMr !i*.w incidents onto il dim l. But wlmt abcst.il ctiits? 
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what about 


How things works now 


Tlirrf fire tuu pJares uliert 1 srii/Tukliiig gives ytju cin edit opliuii. 

()n the orijrinal scallolded or lIip 4 indrx' page, yon t mild c lic k the 

L Edir link n^xt lo (Uiy the rtitxuds and junip it \ ilit j edit Qirrn. But wt ， 
ciuii dru in ly tiling like Lhat mnv because die lisi of incidtrriB on \iic index 
pagv ha^ bt en trplaccd by the map. Arid \\v know dial the map partial 
doesn't ha\ r e tiny “tklit ’ luncdon^ buili \n r 


Listing incidents 


Ijicldcnt^: Inrtex 


llttp ：/； lOC^IIIOSt ： 3 CHM>/I 


Mountain 

Hou 

RuANaaI 


b3 



Su wliere ehi j rmikl we edit LhingH in ihv oiiginai stiiiToldin^^ \VelL 
iiiiadi^r place is in die uicidi 3 iU "show" p 咐 】 ■ III the aCciili.)!ded version <^l 
die application, there wa^ m “Edit” link on the h 、 how" page. 


There i ^ Edit 
Imk he^e.1 ioo. 



So could we do something like that? Hmv about il wc add an ‘Us link 
to the set of details that are disfilayed in rhe pop-up window. 

Would that work? 
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rest ajax 


We could have m "Edir [ink in the pop-up 

We need to add im cxiir link to the details that appear when someone 
selerls cii i. ini'ident Irtsni the rti 平 lint someour clicks on lht A “etfit" 
link, we switcli the contents of map_info <di\ > to display an edk 
ibrm and then use that to amend the reccnd. 



Listing inciderilf 


Listing tncidefits 








Wo aireadv have the “show” funcuon built. The “edit" form should be 

j 

similar to the 、 icw” tbrm, and we already the back-end code in 
the controller m amend the record. 


How hard can it be? 


you are ft ere ► 
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two psrtiBts i 


Well start by modifying the "edit" 
action 

\\v net. fc d tionif v^iiy ul ^ernfiatinij <m vdli Ibrm tl mi wiJJ 
appciir in the pup-up wiiidovv. 、 Vt.U create a panial called 
一 edit * html * erb. The partial looks pretty similar to the 
new,html.erb: 


app 



incidents 


edit.htrnl.6rb 


<% remote_form_for (incident, : npdate=> l iTiap_info , ) do 1 f I 

<p><%= f.labil : mountain %> <%= f.te^field mountain %></p> 

<%= f *liidd-0n_f isld : lat I i > 

<%= f,hidden^field :longitude 

< P X%; f,label : When %> <%- f,d^tetim^alect :麵 %></p> 
<p><%^ f,label : title %> <%= f ， text_field : title A></p> _ _ 

< p ><%= f-label rdescription %><br/><%- i -text_area : description 

<p> 

<%= f.submit “Update” ％> 


rows=>3 


</p> 

<% end %> 


So why have two partials? 

Thf pariiab aie bai^icolly the rodt% but ii s a gnod 
idea to kv.vp liiem Al ilie monit s nl tliey hol!i look 

the hm dun nii^lit noi always lx k ilie ca^e. 

an exr.iiinpie,, we mi^hl want Lo change 1 whiit finu lionaJily 
h avaiiabltf llimLtgJi the ''new'" and pages. Wt a rniglit 

decide that vve need users to insert the date of an uiddent ? 
but uc may want lo stop them edit 域 g it aitenvard^. Another, 
possibility tliat we might want to make rhe two pa.^es look 
jrom each atlif'r 


TKe todt in _cditWtwl erb and 

sve iKc 7 七 W 

well kaf tWem m 


i 


es 
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rest ajax 



If the two forms look the 
some, X wonder how wi \I 
insert a record into the 
database and the other will 
update a record? 


Q 


Ralls knows if the form’s model object has been 
previously saveil to the database. 

So die code Thai the form tor hclpri 1 generates changefi depending 
upon whether it is dealing with ati unsaved object (in ^vl iidi case, rhe (ovm 
will rail I lie action} or an ihal^ already been aaved in the 

piiiit (in which case, the lorm will ( all ihd “updau]’’ acdtm) B 

Talking of art ions, u r ell an n^ating pai lial s we need in modify ihr 

"ediT action method in the controller lo retui n the K Vdil' partial when it's 
CcilJcd: 




Dumb Qiiestjons 


How does Rails know if an 
object has already been saved? 


(V 

Why do we have to have hidden 
fields for latitude and longitude? 


(V 

But we don’t have fields for id, 
created at and updated at fields? 


It calls a method called u new. t 
record? H , That return true if the object 
has nerer been saved 

(w 

Why does ib new .record?" have 
a question mark at the end? 

A, 

It's a Ruby convention Most: 
methods returning true or false, have a 
question-mark in their name. 


J~^l We don't want people to etM them. 

q: Yeah ■ I know that But why ewn 
mention them at all? 

The form object gets converted 
into the fields in the form, if they weren't 
mentioned in the form fields, they would 
disappear 


No - but Rails knows that the/re 
needed, so the form„for helper m\i create 
them far you. 
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ajax-style 办 

And well also Heed a new link oh the 
show page 

m sliuuld now be aiile Lo gtnuyiciLt , an c?dit form, hni huu r will Uie 
user ffet tn k? We need ait "Edif link to appeiir wiicn the us^r looiis 
at the details of the incident. J he link will need to be added to the 
_show . h tml, erb paitiaL 



l ____ 

Cl 

Listing tncidentm 





lb gene rate the link, wc II use tilt ： link to helper. 
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rest ： ?ri ajax 


So how do we use the link_to helper? 

Tht ： ]ink_t.o hdper lakes ^vn ps-ii'LimrUTs ： the umwt the trxi m 
I]k._ link hi ul ilit 1 p\ t n r \w.rc guing lu. 

<p><%= Iipk_to "Edit_， r "/incidents/# {incident,id}/edit n %></p> 




OK, thatit, IVe had enough of these frca 
paths we keep using. Why do we have, to keep entering 
the^e long strings? Didn't we already define what the 
path^ ore in the routes? Can't I just say "This the edit 
path for this incident object^ or something? 


That’s a very good point. 

So !hr \w ha\v rmikd luls tA' paths itrid L T RLs n^iisli'iEi^. Bul wlial 
il' we s:haiigt? tlic format of the links in ilir future? We tan fix tilings iii 
llu- rnute^ prcti) <jiiirkly, l>in \vr- will havu lu【ut ic ikmclanl ^(lingb in 
the code coniaming paths. 

1 hiving the siinit 7 s<nt o\ inR_rmntioii in lw" places is 1 btxvm 此 it 
breaks an important Rails piindplc; 

Don’t Repeal Yourself 


一 


But if the routes already record the structure of the 
paths and URLs, maybe it’s worth looking at routes 
in a little more detail. 
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irestfui routes 




i^ 3 TM 時 C! 



So liir wv\v moated individual rotitis in ronriy/using tht 1 
. coniieLrL coinii^uul: 


map.connect 1 incidents/map /: id F r : action=> 1 show_with_map f f : controller’incidents 

Bui yoi[ may ha\i j when yon \wrr t a rlit in^ if le niUtesTb Hie lhat Rails 

sea Holding ^eiHTLars Ils rouLes wilh c\ difTt h R fc iiS roimnamh 


map,resources : incidents 

This single cnmiiuiiid gfii^raies of set of }§t:iiidard miiLt-s called llie RESTful 
routes' Tlu. rouiivs providi. access to ihc stiiiidaixl CRL D operatiotiit with ilir 
application. You [an examine the routes irom tlir console using the rake tool: 



F 咕 Edit Window i-^ip REST^iRoyttsR^li 


> rak €： routes 


incidents 

formatted incidents 


n^w_incident 

formatted new_incid&n t 

edit—incident 

forma11ed_edit incident 

incident 

formatted _inc idenL 


GET 

GET 

POST 

POST 

GET 

GET 

GE7 

GET 

GET 

GET 

PUT 

PUT 

DELETE 


Cr 


/ i rieidentis/news ,kml 
/incidents 
/incidents * : foriflai- 
/incidents 
/incidents， : format 
/ incidents/new 
/incidents/n^w* ；fornia 
/ incidenus /: id/edit 
/incide^t£i / : id/edit, : format 
/incidents/：id 
/incidents/ : id*:format 
/incidents/:id 

/incident 5 / ;id. : format 
/incidents/ : id 
/: controlifij- / - id 


controller^> +, i5lcid ，entsW * 

: contxciii^-= >< ， incidents .、 

: control e => 11 incidents ”， 

: control Ler=> M iri.cid^nt3 M # 

：c ont rolier=> tl inci den t s r 、 

i con trolier=> ,1 incident s 1 % 

: controllers ^incidents", 

z ccnt.rol lei' = > 11 inci d-en f 
i controllers 11 iiiCad^nts'S 
: c ontrol it^c idents w f 

: controllers^* 1 irieidents ,1 # 

: controIler=«> ,T incidents Tl , 

: controller => w iricic^nts M , 
: controll^-r=> IK incident 


action*> n news' 1 I 
actionsVindexq 
^ctioi^^^index^ \ 
action^ 1 ' create^ t 
dctiori =? 卜 [reate”} 
act:ion=> 1T new’_ i 
£ictIon= , > l, riew , '] 

act! on=> n edit 11 } 
actiofi^> n edit n J 

ac L ion=> l,f show 11, } 

ac^io,n=> ,p upd^te 11 J 
action=> ni update p ") 
act ion de^t t'oy n 


Each of these liiU's is a single routi；\ mid in some case^ the mutes arc named. So 
edit incident is (he luimt' ol th( "/mddems/ ； id/cdit" mute. 


But how does that help us tidy the path in the code? 
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rest 


ajax 


Rails provides helpers for each named route 

Jliufvc R1LS E fill imitc names aic inripuilaut. because they lielp you x'ofer to a rouie 
from inside your code. 1 hey let \mi turn this: 

"/incidents/# \ incident.id}/edit" 

into ilm: 

edit_incident_path (@incident) 

l^i>r c\vry nainet] nmu' R^ib gi'vs you liel|>rrs ^rnrral^ pnths on lhr U K ； a! 
server and complete I 

Paths on the local server 

^■lit inc 1 Jent j>ath (@incidont) returns /incidents/3/edit if @incident licis id — '-i 

Complete URLs 

edit incident url incident) reiunis http: //1 acalhost:3000/incidents/3〆edit 

I hey Vt* Oiilk'd RESTfut r <milc helpers Ikduiw i|u j v cm\ i-esotircex^ or m< _f[d 

of)jrets h as paiLiirM/Lers, k<*nlumber - tmv of Lht a prins iple^ i?l Rl'.S T is t" iliiiik ol 

u-'ob applii ： iilkm5 aia coiiliiinera far re soured 

The helpers for incidents ;jnd new inciden t are culled wiihtmt \br 

example, ils incidGnt3_url ⑴ - Incidents_path» 

Vhv. routs 1 In lpers will m>l only rerhmckiiu p;i[h li>i niciin \h.nii ymir code, lull 

lliry iirt 1 also uafiitT to read iind red nee the tjiciiices of you ntaJdiig an error in path 
description. 

So what d&m tlial do lo our code? It changes from this ： 

<p><%= link_tc "Edit M # "/incidents/# (Inci^isnt ^id) / edit" %>< /P> 
into I his: 

<p><%- 1 丄 nk_tu "Edit M f edit ■一 incident 一 url (iriGident) %x/p> 




are her€ 
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test drive 




fasT Drito 


So once ili^ "'Kdit' link ha-s l^en ^dded to the “show” partial, whar happens 
when we dirk on an exiting incident on Uip map? 



Tin: link simply took the browser to: 

ht Lp : / / loca 1 1 : '^000/ Lncid^n L. i 3 / 5/edi L 

Thr trc juble is, this now sends llie rontf nta of the _edit, htm l -erfo 
pan id ha< - k lo ihr tirow^r like il was tin other pa^t\ 

We really need to stay on the same page in rhe browser, so how do we fix if? 
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Chapter 9 





























rest i ajax 


Ajax links to the rescue 

l ht 1 "tk j U ' l Ibrns we creiiteJ t'tkrli^T ua^ uhlt 1 k3 it 1 place tii(f conlfiits 
oi' the pop-up inJnrniads>i] window because it made an Ajiix call to 
tlie server」t u&cd tlic seiver rcspoiisc^ lo replace the contents of the 
map—info <div>* 



But the link we ju^t addt^d didn't do tliat. It ju^t luld the 1 irovv^cr to link 
ti：j another pagr, II wr ci^ate an Ajax link instcaci of a browser link, wt- 
can gel around ihe problem 

An Ajax link works a lot like an Ajax form. When you dick on an 
Ajax Jink, ii doesn i tell the l>n svv^r to go lo a diHrem page, insu ad ii 
genun /\px requ^sr to the 汗 mn，and the response to update 

pari of the pagp H If this snunds fomiliar，irs because links are 
almtiifiL itknLicul kf Lhr Ajax hiilun\^\ wtf usrd i j ai !ier on lu rrlreslj ihe 
seittiisy; Ikt at C'ofonut Air wavs- 

Fo tomwL ihe link ink) an Ajax Sink wc havd* cliaiige I his: 


<p><%= Link_to "Edit", edit^Incident^virl (incident) %></p> 



<p><%= 


link to remote ir Eidit: lp t : update => 
: url=>edi.t incident url (iiicid^nt) 


f art of ^ W ^ 

” map inf o" f the u"pd3tc r 

%></p> 


_ wi ^ 心 HTML 

The Jink should now generate an edit Ibrm (tom the server and display 寸 tf 

it in die pop-up wijidow, Lefs see how it works now 


you are hBte 
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test drive 




Tqst Driws * 


When wf dick on an incidfiiL llie infornicilion window t^iokn exarEh lilt 4 symr 

w 

as I Jt a !bnf. 



The ： link looks lh* a samp, bui rpmertilic^T that behind the scenes, h’s no longer a 
simple link. Inslecid [here's ci uliule lot t>l JcivaScripl mojo iroing t>n ? wailing Lo 
generate aa Ajax request when tlio link k clicked. So wlutt happens uhcii \ve 


dick it? 



UV That 如“ 七 
look 今 ood … 


Instead of displaying ihe cdii form, we get this weird ; l iikuown action” error 
So what the li^ck happened? 


We need to dig a little deeper into the routes 
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rest ? ajax 


WeVe using the wrong route! 

When R』s mri'm [he Ajax request from the link^ lilt' Ajax link sends 
(jut a ivqucst correctly to: 

http: //localhost: 300C /incidents/ 5/edit 

Instead oi matching ihc request to s.he edit_incident I'oute. it 
matches tr> one of the default routes: 


incidents 

forniiitted inci^r：ts 


new_ircident 
formatt 白 w—in cident 

edi deist 

f ted ^di t inciden 1 

•t i - MS *--. «rr i 《 一 沪 

,i nci'isfit 

incident 


GET 

GET 

POST 

POST 

GET 

GET 

GET 

GET 

GET 

mTS ■ ni'TST 

G£i 


PUT 

DELETE 


/incidents / news, 
/incidents 
/incidenta. : format 
/incidents 
/incident s. : fo 
/incidents/new 
/incident 穿 /new. : fon 
/incidents/:id/edlt 
/ incidents / : id/edit 
/iri.c±dent3/:id 
/Incideiits / ;id ■:] 
/incidents/;id 
/incidents / : id. t forms『■ 
/incidents/：id 
/ : coti i 1 £3^ / : 这 ctioo/ : id 


ooita 


limbi' 


\ : control I e 
] : controller=> 1 
( : controller^>' 

(;cantrolier=^ 

: corv:rcller =〕 
i ; coriHrQ llei. -a > 
j : controller 
{ : controller^ 
{ : contro !_lei 
( : controllers 
1 : controller^ 
I % cont rol 1 白丈 =:: 
[: cont.f*ller=^ 
■: : cOnorolier=> 


， nc_Lci€i-ts’ T _ 
incidents ’、 
incidents' 1 , 
incidents 1 % 
incidents 11 f 
incident:a % 
incidents''^ 
incidents", 
incidents ' 1 1 
iriCi dents" _ 
incidents n _ 
Incident 
incidents" 
incident3 u 


zactton^'^ews 11 \ 

: at t ior.=^index } 
r a iof!=i ndex 11 i 
: actiors=> M c.r$ats" i 

: action=> H Q^eate^[ 
: act ion=> ,, n^w FT 1 

:^cti on-"> r, nsw 11 )■ 

: action=> r } 

: action=> n edit n 1 
； action«>' , show , ' S 
: action ^ 11 shaw"} 

: action ^ 11 update pp ] 
: actioTi»> ,1 □pdate w ] 
: ae t i Gi i => F ， 扣 S110 y ’ 



Rails tries to match it to 
action |>；iranieier fo *5' 
t::itl-e b ci \"i' n so \i J'uih, 


the cklault route near die bottom, and it sete the a^d ^ edit— w 
rsncl the del par^imerer to > b dit\ Tlieiir^ no arlion 




I lut how can Hiat lx i J ( >ur l' III, i h up;// Ioca 1 ho^x : !3f)(iO / inrklems / .1 / edit 
thff ： same |)；ith form Hi as "it ed it_i incident route 
'./iiI ， rick A iil>i/ : itl/rt]i[). So win. i.lidn'l it mifcLdj. J AWvr iill.【he link w"rketl 
line !>ribrc \'c t uiivtTk'Ll il k) Ajax. 





Look at the list of routes again. The original link and the Ajax fink are both going to 
the same URL, Why do you think the Ajax link was matched to the wrong route? 
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more route 


The HTTP method affects the route thaf s chosen 

Thrrr^ "11c ca 1 1 ei kin iu ； llic routes dmt wv\v iiol riallv I ⑻ ki 乂 I al: 

■ JT 


f 


Lode 叫 Ws h ㈣ 


r 


Incidents 

formatted iricid^ntg 


new_l incident 
f o ona 11 n c Ident. 

edident 

format ted _inciden' 

incident 

formatt-ed i m dent 


GET 

GET 

POST 

POST 

GEf 

GET 

GET 

GET 

GET 

GET 

PUT 

PUT 

DELETE 


i.- .cio^nts/n^^s r 


!1 丄 


/.incidents 
/incidents.-format 
/incidents 
/ inoi d&n t s ■ : f o rrnat 

/incidents/nevi 
/ Incidents/nevs 1 . : format 
/ incidents/ ： id/edit 
/incidents/ : id/edit»iformat 
/incidents /:±d 
/i ncidents/ : id *：fo 
/incid&nt^y t id 

/incidents/ : id - tfoxinat 

/incidents/:id 
/ !controlI m/ : action/ : id 


t :controller=> IP incidents", 

I : co n.tro 1 i er= > 11 inn ds i\ •- s 1 f 

(:contro!ler :： - i > 11 incidents", 

{ : contiroileE-^^incidents n , 

\ : controller=>^incident.5 , \ 

[* con t r oiler=> n i 郎 iden ts pfc r 
{ : nL ro 1 E ] er = >” in ide t 

j jeontrolleisV’incidenfcs' 

I : cent roller incidents ri , 

， conti：ol ler-> s, inciden12, 
i : .cionfcr q 1 M irHi*ide ， 

t : c£jntrolIer^> 1, incidi5nt3 , % 
I : contrrrlLer^> ,t inc:ident3 l> # 
j ^ 0 q fO ■! ■丄己 f = " T"l i - 二 ■」e 】 I L s , 声 


So wh^tare U 碰 GET, POST PUT and DELETE word^ 
about? 

They art' the HTTP methods called i!it s HTTP 
t?erb& a . E\ (LTy reqm^L uses a pailit iiKii 1JI I l y inetliod, and 
Rads u^es ihi ： mcihud as wd ] 办 thv p^xth to ck 乂 klr u'hith u nu <： 
to use. 


But what exactly are they? 


s action M I 
: action=> Bt index’’} 

； action-> n inctef j 

: act ion 卜 create__ i 

rac.tion»> TT cr i feate lp 1 

iaction => 11 new"} 

: acLion=> M new M j 

:^ction=> pp ^dit*- \ 
:a[tion=V3hC!V) 

； ^ctiofl"> n show H ) 
； act,ion =^ 11 update 11 } 
: 11 \ipciste n } 
: ac±ionW 如 strof 
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rest ; ajax 


So wbafs an HTTP method? 


Dt. b s].)iU* t\w iiitmr，M I "1 P uirllicids [tic a mi]' nothi 叫 like thr Rnl>) 
inclhucls v"u lirtd in. sav, ii a >iitr< Alvt. histratl. an JI i E V m" sethod is 

.J ~ iT * 

inontkmod the low-level HITP-talk ihai I uippeiis when a client 
contactH rlisj server: 


With the KX method 




With the POST method 







at start J ^ 
P method ^ ^9 5nd 


ttil 


pkat 



POST /incidents/S/edit 



So why did Mie two versions of ihe \mk do difim a m (hin^? Well - 
(irtllijiii ) H FML hypn links srnd GET iv'< [lii-hIs \u dir s(t\ct. Bin, l>) 
delcUilt, Ajax links %cnd POST icquests. 

So lu iiiakt' lhc fc Jink wark, \\v nfsu lift'd in tH] i he link what HTTP 

mrlliud tn use l\kv ihis ： 


p><%= 1 ink_to_renaote "Edit" f : update => ,r map_Inf o TP ^ 

iur 1= >edit incident url (incident) ,, : method=>"get r %><： /p> 


you Bre hBfB 
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tone more) 




Tsst Drivq 


[t ^vortst 

VMien \w dick on an uitidcnt link, we tin .： in formal ion dkpliiycci witli an 
"Edit" link 】 When we click ojii the link, k creates an Ajax rw|u«t Ibr ihc edit 
form, which is used to replace the contents of the pop-up, 



And what about the Ibi m? Well thaL w)its pretty like (lie “new” tbrm did. 
It updates the incident and then redisplays it: 
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rest ajax 


th^r^stre no 

Dumb Questions 


Cr^- Is it really that bad to use strings 
as paths? 

A- 

r\. Strings will work, but they will be 
harder to reader and more prone to errors 
ihan using the helpers- 

o ： Why more pron& to errors? 

l\[ If you mis-type the name of a route 
helper, RaSI& will create an error md tell you. 
f vciu mi^ type a in a ^;n ! ig the- : sy.5:cm 
either not report an error, or report some 
other error caused by the bad path. 

Why does link to remote create a 
POST request, byUink to just creates a 
GET? 

J\l link Jo creates a simple HTML 
hyperlink. Browsers always tiss GET for 
simple hyperlinks. But link_to_/emotG 
creates an AjaK request and Apx requests 
are always submiUed as POSTs by default. 


o- 

Why does HTTP even bother having 
GET and POST? What good do ttiey do? 

GET requests are designed to be 
repeatable. So it shouldn't matter ho# many 
times you make the same GET request. 
GETs are commonly used for request that 
jusE read information. But POST requests are 
used for requests that might change the data 
on the server each time, so they're normally 
used for requests that update the database 


(v 

w So ts this how form for is able to 
the same code to gsn^rate forms that 
cam update or insert? 

Yes. If the object has already been 
saved, then form_for generates a form that 
will use the POST action. If the object is new„ 
then* it will generate a form that uses PUT. 

Someone told that browsers 
can t use PUT and DELETE. Is that true? 


So what about PUT and DELETE? 


PUT is used for requests that will 
create new records in the database. And 


Very few browsers support PUT and 
DELETE. So to maks sure that things stitl 
work, Rasls sdds another hidden Md called 
■ method 1 winch stores t!h& name of the 


DEL ETE i$ used for database deletes 


Oj 

Is that time for all web applications? 


It's (rue for Rails apps. Using the 
correct HTTP method is v^ry important part 
of RESTful design, 


HTTP action If a request is received with 
_melhad=Tirr p Rails will treat it as a PUT 
request, even if it was actually submitted 
with a POST. 

But what is RESTfiil design? 

A(\ lf ! sa way of designing web 
applications that tries to stay truer to the 
original design d the web. You can find out 
more about it at http://tinyurt,com/28nguif. 


you are here i 
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ifs a 


Head First Climbers needs you! 

Hit 1 iiKHiiiUiinecrs mv luviitg the applkalitju. But ue think 
yau tan do a fetter job, 

li\ Lini^ k* hty yotir ihui^ dou n and striously pimp (iiis 
Applkation. Aild more details, add more widgets add 
more c\v candy. Here arc some ideas: 


tr eate ? 

Late - 

W ? ? 

about 
tVi£ 

inti denis 

社 c ctMptdirbod 

eUt? 



H ㈣ abou 七 m 岛 
uf the i^ask —叶 wiiK 
another Web Z D 

奸 plieati 加？ Why tar^i 

wc straight 

the top KZ? 


叫 士 feople 
P 。 蚨 ^hra ^\} e& ? 

Ph 知 I 也 videoSj 


Hovj about Cometting 

七 he ifttido'ts 

㈣ 钱作 W 必 sor^t 
sort of 》 

objet 七？ 


ItUe 』伽 

^ w r 



Build ybur best version of ihe \{e^d T\i^( dimlm 

app, {lien submit your X 3 RL in the H ea ^ RfSt Labs 
%ad First Bails” foiwi. You stand the eknee of 

winning a bunch of O'Reilly goodness and die World 
Wide Fame of being fealiu ed on H^ad First Labs! 


CTREILLY 


的 htre 4 iv <m how {a 

enter 士 he fiGht^st. 


A ^ o 



Hf 此 fim LiUi tiQm Inu 


，卜 ije 
■ - * * 


4 - ^ ， H：nfi / /wavv 朽卢 ad 

inruum. f rtm / / 

/ 

" > … 一 一 1 








Guidos from fi^Rctlly Media, Inc 


彘 



Head/Mpst Labs 


4 


^9 


^2 


Ml 


iSftSS 


EEiesifia 


K -X^^ 

4 j 



1/ 


aebfi 

1 and 

1 Rail 

f- 

iPlj ri i 1 ® J 


卜 jil_ ■ ■. - 



rcsid 

lc Ch 

d( Wl 





\i,f\ |f^fd 

: rvifwfrd 

H i f_ 



fQJ 

f tecr 

inical 




£li Hfjjd nrii 
Cfirri 




• 瓤 4 g 

M KS S H^9 


^ m 

TWfffM. 































































rest 


ajax 


Tools for your Rails Toolbox 


You’ve got Chapter 9 under your 
belt, and now you f ve added the 
ability to add more advanced Rails 
functionality tp your web apps. 


^ uTooU -T 


cfej 技七 


i.-gA) v 扣? 办 
< w 枷一 v 

^ ,, V ^r^- WURL 

nt : 仏一?办 



399 




10 real-WQrlcI appliccttions 


命 






Rails in the real world ♦ 



He's all grown up now, 
r hope he doesn't go 
off the Rails, 


• 5 ^ 






S' 


觀 


■’ i 1 








' s 


■ 1 i 

r>k 


You've learned a lot about Ruby on Rails. 

But to apply your knowledge to the real world, there are a number of things you need 
to think about Haw do you connect your application to another database? How do you 


test Rails apps? How do you make the most out the RaiSs and the Ruby language? And 


where do you find out the latest on whafs happening with Rails? Keep reading, and wel 
put you on the inside track that will take your development skills to the next level. 
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always 



r can see weVe covered a lot of ground 
for building Raib 收 eb apps, but thats 
just besn in the book What dbouf in 
the red world? You carif tell me that 
everything goes like this when you're out 
there developing in the wild... 



All of the techniques youVe learned so far 
ARE useful..* but there’s more to (earn* 

Vos, it ^ H ue. Tlihig 、 uu\ In I lie v\ r urkl dov\[ rihvays go tin- 
way they «h«juld N^>t "nlv thai, l>nt Ra ih is a |wtsy l>ig 
framework* There^ more lhan this bofiL, or any othtr 
hook iJlii] lI (v\\ /illinn jiag< j s, ruukl m’r lo 
covei, 

Kiie llsm’s ri" n k asnn lo iisMime not pr«* 『 K，i i ； d! 

Skim liu>ju^ii [livsy 1 Lul lr\\ jja^ j s Lo str wlial you kii< 
aucl vwn pick up a lv\\' mm sipu uii iliiii^ you don L 


402 



rea!-world cations 






mot i 


-¥ 


Wt only cc^ered a handful of the many helpers dim air avtiilal)k" in 
Rails, bin there arc pknty morr to clioo&e from. See if you cart raatch 
di h f>r I lie helpers bekiw u> vvliai it ^cturilly dnn 


number to phone 


ji'Ls biMWsn s ^lULodclrcl an kSS Hid 


nLimfceE bo percentage 


Allows \i I Li tilin' In i\\ If nm I >ibn i A 
template code take to nni. 


error unes^aae on 


l;>raum a iminlitu 丨 I S j>hone 
riiiniher. 


auto discovery 丄 ink tag 


Fonmus ii mmiber as n jjen'tniu^ 1 . 


image tag 


Rcturiis a see * if selecl Ui 办 l\n war 

~ A 

m< mdi mid dav. 


bsnehmark 


Hi'lps vmi Eu your m<»r 


fries 尬 


date select 


Returns an iimge ia<r ih^ii you ran use 
in r A U fc nipliiie. 






know your 


■' 


需 . 


ir 








囈备 UUT4 备 M 


Wc only coverctl a liandful tA' the many helpers that arc available hi 
Raifc, bin there are plrmy more to cliuose ikun, See if you can match 
rach of Uir helpers belo^v to what it actually does. 


number Ko phone 


number to percentage 


error message on 


image tag 


benchmark 


date select 



auto discovery link tag 


I Ails brmvm aii KSS [rvd 


Allows you to dmf liw long bils ol 
templntf code take to mil* 


I Iinnate a numl^ r as a L-S plione 
number. 


Formats a nuinlx'r as a pcn entagic, 


Rehirns a 叱【 of selerl Ui^s fbr year 
moiiOi ctiid dav. 


Helps you to formal your error 
messages. 


Rctiirns an image tag that you t an li^c 
in a leraplate. 



Geefe Bits 


To ffnd out more about the helpers that are available in the 
current version of Rails see http^/rtinyurlpCom/railsKelpers 
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maf-world ons 


Look! It's a big Ruby Try this" page 

I )ii! vf)ii nodrr liou hull Rut a \ \m hiid to knou in oixkx ⑴ dt.VL'l 叩 
c<>cil R;iik web ^[jpsV l£\vn so y kncnvii^ a hit morv Ruby can 从 mirtiiiu 、 
lx- u^-luL Here arc somv i^ainpk bits o( Rulsy you mi^hi waiu \o 
E s xpt.Timej^ wnh.Jn^t r>pe them in aiul see v\liai hiippeu^,. 



Tvs ttJs! 
♦ 


Read tlir lint*% of tilr iavln an array a ilk：cl i£ a 5 

/ 

a=Fi le,readlines ("* t llename, txt lh ) 

S< ni an ^irniv 
a * sort 

/vvrs (■“ yliiiiu: 


w 

+ 


+ 

+ 


fld-'-js ac «cwards ir , reverse 


liruiimi ol. a 斛 ring thas is rcvvmx 

ir Rass ackwards 1F reverse 


I Hir String s contain Hildr ，』 


Waldo/ 


s 


tin 1 JSli iny a zip codr/ 


^\d!5}5 / = 


9021D 


t :‘>t]vmiiis a Mring u> a l l\mmi 
”l2 345'to i 


i (:oTm*n a Siring to a jltKii 


3*1415",t:_ £ 


Com F cri tin nlijctl lu a siring 


a,. to s 


i - ■- 

i L J retty-print the contend oi aji array 


[1, 2 




51.inspect 


l 3 rrl(y-prini ih< r i'cnL^ius ul' mi ； irr;iy 


I : a= , :b= 


I * inspect 


t-rfate a string with 50 --signs 
w * 50 

(ict an array of wards f rom a 卜丨 ill 


bi 


r not to bt 


s’ 


Rcliirii the i'Lis^ kLiiiLil\pi , j (>l mi otjii 


H d ： A^^ 


Riukiui d Fli tat u y thr nearest wliole iiumbci 


3,14).round 


Kind n ^qnarc v -rocj( 
Math,sqrt(16) 


Uv\t ie ii fik- 

File • de 丄 ete < “ f i 丄 • Lxt 1 ' J 


I lie ciIrrent date arid time 


Time . no 1 


1 Ik' riJrm”、tw 

V 

Time.now.year 


! i\v a liiCtiind iiiiolliLT iianu- 


alia ：-： mv m^tho- 


Return an array of files in a directory 

£ -i 

Dir ，- entries ("directoryName 1 


+ P ■ • + 寺 


警 + 甲 ，■#■ + #_!!■»+， 1>|+等 PH 警 + + 


)u are I. 
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testing Btiei 


Web apps meA testing too 


Ali tomHtcd [i'sLn'ij* is our ol tJu 1 nif>sl imporlaiit ] jails ol 
(Jrv.HnpTiu.iU, iu id yfl uelIiI now. \\ 7 c Jiawn'l nix nti^ nuul ii. So wli)' 

I a pii-t r ni ^.sihviirr rrlio^ f m a tin n'ough mKliTsuuKliiig 

，■卜 lln. 丨 … MMiiLj. .iru] ■ I'M.iiin^ 『 rM” _m hr l:ir 川叫丨丨 " 1 _ ! 山 

'anf! enj<pynlJp) ilvm wriiinR i\w mile iiMrlll Midi's wliy ihh hi mk lins 
ra>mviilrciC^d c \t\ iiiji; you I lie skills (\ i ijmlrrstimnl \uw Rniils ^ orks ;iik! 
ihinks. Onh oiK L fc \ i\u Lfciidri Hlctutl \hd\ ran v(ui hLliI in iliiuk a\h iiil ht 

■ , i 

you will test applk atiom 

Bui [hai di^esiA iiU'cin lhai you du Icsiiiu ； k"ig iiiirr ymi liiivi 1 linishrd 
urkijig ii syskiii. lur itnm it. i hv bnl try Is kwe UTitk'n before y^.ni write 
vuiir mahi o >(1 _乂 

IT 



成微 * 


a 


Ruib» comes with a ttm of supporU far nw n c Uum Almost iiiiy udier 

lr ； iini-ur>iL Kwi y applii.iUiaii a scl ol' ksB sn ipts i.iii iln ： k.sl 

dim s … y;、iiiid vwi y 祖 hrn' you genei'atr scaflbldingj Raik als" generates a 
nr standard tests for you. So* if you go into the folder where you wrote 
(hr lirkHs 叩 plivatirm in t r haptt fc r ] rind lype: 



Rails will run a whole suite t>! teste for you- 】)m that im-an that \ou 

■* ■ 

nrwi- nrrc.l to write vrnir c:m n? Acmallv, un r A lot of yum lum: ^ K^uh 

ri a * ■ 

dc\ekiper w ii] he spent wTiiing and maimaiiihig re 血 
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So what kinds of tests are available? 

llieu 1 tux j tlirec iuix\n h pcs t.A' 

Unit tests 

Rails sorneliriw uses lernin iluu w nol (\iuh x the s<mu* lis you’ll (incl 
t hrulien\ In Tin )^1 Myslem、a "uiul L( k si" Ls ii tol * 卜 I' any ^Uyulah ms 3 |iit fc re of 
L<xk'. Ik" IHis m<n spt.t ifk 1.1 1 mi 山 iit. In H li "unit trsf iiieait>i ci 
£]f a model c lass. Rails creates standard unit h.sts ti>r \ou m the teat/unit 
ditvcioiy uliencvtr y"u gvtienue a liitsdel tithrr dii'tTih ； nr via 、 r;tl1i4ding _， 

Functional tests 

UliiU Rails iiiduis by ii rimcti ⑽ ill U'sl is ri U-st n|. ‘m intliviJiiiil canti'alhT. 
Fmictional clieck that il' you iiKikc a partsculai kind of request, 

\nu irfi a pimicular kind t4 ⑸ ■. Wju ran find llinctional tesh in 

test / functional ， Agnin, Riiils vveaic^ linn tioml tt^ls whenever you 
g^n^riil^ diUrnllfTh riiher dirpclly nr via s< alTnldin^, 

iMtegratioii tests 

This mv high-l^vH ih^i r^nr! ：i ii[th fc iiks s ilie mvi of Ii'si-sitejiIs ih^U 
nnuiLUil [esu.Ts UsiL Iiih fc y raiion k^sis li'st i lu- s^si^m ^ d win lie. So \hv\ 

? J m ,J 

auLtJiiiiite die s^t of actioi^ that a typk tii u^er miffht perfoi iii on your system. 
'Hn-ri ： is a sprcki] tuldrr lor iiitcgiaticm ts:sb {test/integral ： ion:、bul 
ihcy are not getierated autrimaticall )； They are very specific what you need 
ycnir system to do and >thi i i.eed to create them yoin ^ir 

Fiiialki itir lest diLEa lor liII of U'si^i is stored in dalii iiles in 

test / fixtures. A llxluir k |UsL a lam y riiirnc Ini a sdnl Iv^sl daia. Rails 
wil] the dala iinm ihr lixtuiCK in .1 spcrial, ivM diiuibasr (n 

makr sure that vrasr devdii]>nu.iii (01 W\e chiti-i) not ^ei iiiLx^c] up w i\h 
datn recjllired for yrmi lests. 

F<^' more iniiM'niiiilion on tesling in rails htfp://tinyurl.com/railstest 


deploy yom app 

&oing live 

Vaiir up] iliratK m nf m'l sl;n in dr\l：]c>p]ii^iLl nil its life. hImlI ;it somr |K)int, 
ynu’lJ ni'ed In seiiti it livr. So u hat i\o you d then? It's not a 屮 xxl kid il 
vehm' applkaticm has in n ij“u thr ul 山 c daial>：3se 

and oti. After all, vthj 6 on\ warn die live and ir>r vei 、 km> llir rodt" 

— 

<! j dr ， clift^n-TiJ ilnn^, Y「_li jnsl w^tie ihen> In me clillhmi HaUii^srs. 

liai why Rails lr(s ynu ^pet ily ettvironments. An i nvitunmnil 叱 is the 
location and hpe of your database ^ well as a (Hv other setting's, such as 
htw h)g will hr rtfn>ix1i j cl P 

By default* an application is set up U\ 服 - three diflerenl envi ⑴ nments: 

development 

Yhk h thr rin _ ir[r[imcm ilnW is used l>v ddhiilL It's tlu- * nviirsmiiCTil thai 

m 

ut ： have been using all Ihc way through Uic b ⑻ L llie ck vdopmcnt 
envirnnmt'm s!k- fih/Hf ： wlnpmen!.^qlm j ：> claiab;iMr, 

test 

This < nviroi mn fc u( is sH ;isklt fc !br [he ust 1 oj' thr aiiium: t(cd icstin^ srnpts, 

products n 

r Jlus is votii li\e nnwHims-'TiL 


O 

❿ 

© 


Put how do you switch between eHviromneMts? 


W hen you start the server，Raik looks Ibr an s-nviioniTient variable called 
RA T IjS ENV. This will sell i\ winch ni' h.otmiriu Ui run. II you wmw tn 


su tirh from the dei^IopmejiL Ui Liu ： prodLtc■ ti(< j iivitonnituU ； 


you need isi st:t the RAILS ENV 、 : iriabk.: 
■■ 

I Fib EjH Window Kafe" 


> set PAILS_ENV=production 

> ruby script/server 


Kis 七 巧匕 切 ^ 

. 3r,d t^is b wkat Y* 1 

for WhA 沐 a 刎扯 



Fil# Edit Window Help 


> RAILS EK^production 

> ruby icript/server 
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reat^world 


So how do you change the database? 

If you look at die oonf ig / database * yml you will find the 

database details for each cnviroilinent. 

R>r (-Xiimpk^ y«iilr original SQLite production crivirorinjiini nii^hl \ h 3 . 
set liktr di^: 


development = 

adapter ： sqlite3 ■ 

database ： db/development -sqlitd 

timeouti 5000 


But il' yciU Wan 1 eel c lian^f tlir produrlitjii envirfsi^iienl In use ;i，n 

Oracle d a La hast 1 ，k wuukt pmhably look sumethin^ like [Ills: 



development : 

adapter : oracle 
host: mydatabaseserver 
ysername : scott 
password: tiger 



Ur, il. yf>u w:mL llic* live ^nvimnmenl in use a MySQL datal 
oil the Scime ni«u hine as RaiJ^, you wjuld il to: 


production; 

adapter: mysql 
database : my_db_name 
username : root 
passwords 

ho^ti localhost 】 
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bone up ;■ fosi 


Whafs mr? 

\\t.ve In, 1 it id a Ixi I in this Ijook itboLil REST Hm 、 Riiilis i ■叱 s R[^S f. lhA\ 

RliST (Ifsign is thr m u gnkling ： priiidpli. 1 uf R«iils, I \o\\' ii ymi 

RKS l: ynur ivcili will 1>< hrightei', vvmr liit- will In- iKippici; and dll will Im- 

gf.iodnes^ and simshine whli the vvorkL 

Lcfhi fit art with the basics. REST ^t£inds for Kepresenta lional State 
Iransifer. and ifs a why ol' siriuluring h<‘vv pop “』 wnrk with romjnMPi 
systems- Obviously, the most important compuier 叩 tem around is the 
WVsrkl VVifIf \ Wl \ 出 hI it’s signUVani 山 “ [ilu 1 ulm r:immp wiilt 

RUS T kov Fielding — ms also one tif U^e authors of die HTTP spor. 

So why i« maitH lhai tlie HTTP ^ is also ihe RYSV ffiiy? VVHl, 
h( j caust B Rr^S I fi]] really itu'iins dr^ipiinjr vour “pplk ulions Lo wwk 

l hr way the wub sxm originally inciiiit tu kd 


So what are the main principles of REST? 



All the important stuff is a resource. 

ihk iiu'lIms is llial ;l!I thr imp “ 此 1 i" \* mr sy-sit'in is 

叱 piimtcly Ido mi liable ill in ^ iliat ynu tan tlo stuil eu. U you htiw wvh 
sitr fhut m j I1s ah nuUs. llvii {hv d<nulls n u ■ ivu.smvr、. 


(3) 

❹ 

© 


Every resource has a proper harrve. 

(>n tlu- wdi, this means tliai rveiylhing has a l T RL. 

You can perform a standard set of operations on the 
resources. 

J he CRLD (Create% RcarL l. pel ate imd Dt?lek :_ < operations are ^ fhiiiy 
t\pir.il o( ^])rr;Ltions ? mid they「ire hiiippiM ied iiy Rails niid the wrk 


The client and server talk to each other state I ess ly 

1 his nu^iiis ih^t w lien ilinit (like bitsvvwTj UiJks t(_ a RES I fill 
iipplicaiHiti, ii. is as a distilsri ol r「q.iests and responses, i hr clicni 
io i]ie RtTver. The server imsum Then \\w cotmtmiion ends. 


All d Ih ihings 从 Mil pt'rtty n[jvir)us„ (l"n’f ihry? 'I'lfcT-y mv prrUy 

good descriptiun of how the w^b work^ 

And [hey werc a good description ot how tlir web worked. Before it 
went wrong". 
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real-wortd oplicBtions 


The web application that went astray 

Ini 叫 iiit: ihi'rv Wiis a web appli(.ati{in dial itUmved somelxtdy to sell 

spare pam For rodfijets: 

T hey mi^liL mraLt 1 n ^ysLt a rn liiat. displays a nu ket c*srnp<meiil like l\ih: 
http; / /www \b 00 ster 3 -r-nfi + com/ a i r f r ame s / 472 

lire web site h about racket campon^nts and this ka URL that can be 
used as the name of ihe component* 

But look at what liiippcris when someone uptiates the details i die 
component, like — say — its price. L lie web form in the system submits 
the details lo this URL: 

http: / / wmr. boosts rs-r-us, com/airf rames / 472/update 

Tht trouble with this is h^s not RESTfiiL Why? Wd】URLs in a 
RESTTul system are supposed to be names of rcsoiuxe^. And this 

兄 miiri URLt repre^n^ a thing it ] an action. 

Why is not being RESTful a problem? 

Have tou ewr i^siied a URL in your bmwer and feen a^ked if you 
vv:nu in repost data? The Imnwr Iviston* is jusi a lisi r>i" l IRLs and 
llial ^liouki nieaii tliaL il h a lisl uf munes. Bui if a vvt. s b applicahoii 
usefe URLis tliat represent attivuit^ then when you go bai k tliiwugh 
your history, the browser won't kiiow whether you intend to redo the 
act loii^ 

HTTP verbs are the only verbs you need 



Bui hi *w do \\'v ^vl cii'oui^t] this pn>blem? The Lhird priisciplc o\' 

RES !' says lhai there ^liould a wdl dc lined liit of' actions available. A 

M 

RES t luJ application uses H \ W metlicKls to detine the aclivity and 丁 

leav-e? (he URL to name the iTsource: 1 ^ L-scd t h £h^ RfQTC, 1 

咖 tes in a ^Udtd 刪 ㈣ 如 , 




CRUD operation 

HTTP method 

URL ^ n 

Orenre a componem 

POST 

http : / /www* boosters-r-as . com/airframes/ | 

Kead a comixment 

[get . 

http; //wwv^ boosters-r-Ds . com/airfrarrtes /472 I 

Update* a component , 

PUT 

http://ww.boosters-r-us.coffl/airframes /472 f 

Drkte a component 

delete n 

騎 . b 咖犯咖 ㈣ 72 1 


you are here * 
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yes, there's oven c 

Living on the Edge 

RliiIs Is rJiLm^in^ nl\ f]u j iimr. 1 )LU \u.m will v[m sik\\ up wkli id] i\w 1 . 血 ] M tiud 
ihULiivH that hiwv huon adclu d? ( Wiiy is tn run hhi ihr Edge, 

R^uh I n Like h real IV ^ run on lU^ vrry tilled buikl nf RliiIs ft^Ued Ed^e 

J J 1 4 i li 

RliiIs) l>)' ck^vnJoiittii]^ and instcillin^ ilw kueyi \ ersion of' llic liaiiie\%cnk diret.Uy 
into yoiif applicaiion. 

Nij\\ in sf »uu ! "Llitjr 叫〕卩 ] iririliuM I id i sir works, cl ns lining lo “k b LilL'st 

oIl the framework would be incredibk 1 diillculi. Vnu vwmld liave go to a web 

l”r]wst v i'Dovmloacl 彳 h< liW, k«-ad thr lares? install in^tnu-i.inm. Play wii!i 

Sri up the conII^iralir>n so ih 4 \i it matches your : system. And so on. It would be 

so rot 11 plicattYl that vvr\ lew p^ojilc would I soilm ： 

Hut lots ol p^H：^|>le nui on Ec%e Raik Why? Well it s s not just because (Jir-y wani 
to use the latest fraturt Knits is in furious development all ihe tune, and you 
]ii:iy I’ukI Ui;ie rven a shimI] up^radp riuKtii l)]vLik piect 1 ol yamr appliciition. 
So lo iiiiifcr sur^ tliai ihuii apj>s wilJ keep working as Rails evtJ 】 vtrs ， they ， h j_i [ 
wait ftII- WL^cks ui' lMOiuii^ Uj LLp^mdr, so]nr df tlioin update In ilk- Edyr t'WiA 
day, 

Bui [m do ynu iiisliitl lul^r Hails in yum. (ippliralit.ni? Ifh siinijJi 、 Y<»li tlo llns ： 


z ^ EjU Airidw Hgi? ^ifgQn^hgEdgg 


> rak^ rails : f : edge 


[hat single rumnumd k all yr m n^ccl 1 he rakf tn"| will I'niin^ct ihf a Rails 
d^wlopmeiit and dtnvnload the version ol ihe rails sn ipte and 

insulL il]-.m in i lu h vmcl()r/p]ugiini dii^ffUjry of ygur appliralioTi. Every timt' 
you sUn'L Lhr Utils srrvei: the codv in ihr wutlo!. direrl<)i y is used lx j i^>n j yoiny 
to ihe main Rails msc^dl on the machine：. I l ii；it meam that Edge R, i ih will ht： 
used tor that single iipplication. 

Life can be pretty hairy an the Edge h But sometimes it 5 s 
better to find version compatibility issues, one at a time— 
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fretting more informatioh 


Ev'( r ik though kiiils yon l<i crntt 1 rulh 、 t\.lm'iioaial ueh 

applk aliens [㈣ and tI k- re's nrs duuln Lo r< ally maslrr H 

tan fake a really hm^ limr. 1 heir's simply so much <>f it. 

This means you need a pretly good referenct. And ihe l>e^t references 
iiiv unlmc. R.iils k dian^ing all the ium\ Evcn r tJay new lhing>i arc 
rlieckrd into \he Kaik oiuvr rude，and tlif only vray ia kt tp up witli it 
h to jTu online% Heiv nrr n r el> [<> 只 i-t you ^liirted ： 


e 

G) 

0 

③ 


http; //www. rubyonraMs. org/ 

I ho heme \ 4 ' Kaik iisd£ [is ik>i only the pkio- ti n s<ilhvaiH _m also 
j>resc nr annuls；, nnd links Inr Juisht-r trading. 

http: //wiki, rubyon rails m crg/rai\s 

This gives detailed instructions uii insiallaibn and crouhlrahootitig, as 
wc\i providing linkfi io Ixmlier ojilinc re^oiiix'c 钆 

http：//ryandaigle .com/ 

RvLiifs \A(m t * iiiUtins ucliIlIi nf iiirnriiudinii sm l\ic hdesi i ⑻ I lricks 

r ~ 

you om do in Rails. 

■ 

http:// www r ruby 」 ang 、 org/en/ 

Mir Intest inlnniiaiirin on \\u h Ruby langini^ 


Fuilf-iH doeumentafion 

As uvll as ls oi' online iiiLUerial y"iii Ruby Rails mtiiliis 

mi>ii rsJ \hi ： E]iing 、 yniHI naxh right "ut t_f tli *； Ijox. Thr iwn mo^t 
inipon;itil oi-mmand line tools air: 


ri <soinething> 

niicri "<sorni^hin^> i% a Kul>\ ih\^ jh；it vrsti need tv know m"iv 
aboul, J ; t>r Efx^imple, i .\rniy ’ will tel! you all iihout thr An'iy dass r 

Anulhcr sumvr of useful inEcnnicilkm llii uimlk 山 r ^:tn server. Grm 

k the niusi cotimKHily u^cd packiii^" majia^nient utol !nr Ruby ^uid tl 
is ym ^>ah]y she command you used to install kails, (imi ha^ ^ hmh in 
stTVer that provider l]ic satiK 4 kind nf API ciluHTmirnlauoTi you lind a\ 
llu 1 l|LE])i/ / cipi.I'Lil>yi h irailsite. Tu sL^ri il Upe ； 


gem server 

a]id ilwn ii|K!m brmvsrr 'a\: 


htitp : / /lucalhost: SSQ-9 / 


hedtimB 


aoi 


A little light reading... 

(H fours(\ licrr d Ilenct ¥h ^\ I^ibs, w/re \k m> k jjuupk-. And it's tiwsn 、 
nutU'i hn\、jTi riii \hv milinr maU L rial is ? tliw’s ucsthing tn beat li riving 
an victual real In jok uitli pnges and ewmhing tn hvlp ymt alisoi1> i hr 
material. N<iw that youA^e got to the end at this book, and \T>ur brain h 
feeling fsi and full nf new Rub)- on RaiJn exp^Tiise* you might want tfs takf 
\ hr rlianrr tn Iry inil itiese (dlirr Iripeiidk iiLii 



The Ruby Way 

W'c love this bisok iU Head Lid ii 1 iig, mraty work, bm it s Ixaiiiiliilly 
VM'iucti hy Hal 1 uhon. Thk hnok that will liibe you on ；3 flap j【]m nty 
* ili^ \iuhv Um 押 I hr ijiiiii*; h iJihi it cWsrft just ^\\v you 

the HrUiils ! sf llif a liLii^uiipe^ but iL ulsu explains Liu 1 philosnphy l>rliind 
llir uf Uti- things that Rail^ sn ^vdi iinm_ 

directly Irom Riibv: Ai id many of those tiling tire tneiitioncd in this book. 

a j / o 



Agile Web development with Rails 

■「his is btjok to t；ikc yon linllier into Riiils. devdoiim^iU, An 

iulnv^hni ； ihing ahoui i< ihiH il is wriiirn Iiki k a HtwIl jpinmi 
So m A Uhv innnlks 1>dbre a new vendori is released, y !x j ui \vrsiini is 
rolcctsrd <jn!iiic For pcEipir lo m out Ai\d uirmtifni on. 




Cookbook 


Rails Cookbook 

Once you get up anc! nmnin ^： with Rn\hn you will probably need \o solve 
llir same kinds of problems eItrI numy, maiiy otlitT h-ivr Und to 

tifaJ wiih l>rfore \ou, Fvm nnl! iimh (kmkhmL gives ii you a dt'lu itms M-t ol' 
|jR , -\vriUL , ii j)it;t i. h s ol cuclc to 味 el you tJirOLiy；Li your dillk ukics. 


QUBLLlr 
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$9at-world BppticBtions 


Head First books od related topics 

No\\ h as \\ : vil as Ejuoky on Ruin :nul RaiJs. you ]nigh[ liud il us^lul In reitd 
U|> on ihe rrltiie^t fnpics. And wliars iln- lx L st way bnnlstiiip y"iir htiiiw 
in a new sub|ect? With Head First bs H>ts, of course! 





4 


Head First Ajax 

f"]]u k s uilli ii km oi I jLlih in sujjpirt Ini Ajax dr\ r t a lnpiucnt, bul to 
rually make tlir most nul of il^ you need lo get to grips with Iidw Ajax rcaUy 
works. And whai better way lhan witli Hmd First Ajax? 



Head First JavaScript 

Ajax is. butli on JavaScript, iind il you know in detail how to lia( k j^ ;iScript, 
yT>ull really make yuur appliration ^ing: Head First in H i great way 

into the laujrimge. 



Head First 



Software 


Head first Software Pevelopmenf 

In dih l^sok, yoLi\t s learned .aImhiL hi aw lo iu tlit j Ru1>y nn lUs 

ii anu ： u>.?rk. Ii you want Lo movr fimi /mghirnnuni ： t( i' r/opmi ftU llicn pk k 
Uj> thk l?onL h will u ： mI\ Ik>\v thv ival pros dn it, iroin limv l" run ihr 

[>]annitig In yrmr project, lo mitoniated testing and ram ii mo us intc^raiiosi. 
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rails 



Tools for your Rails Toolbox 


You’ve got Chapter 10 under your 
belt, and now you’ve added some 
real world things yoy need io think 
about. 


O 气 : If f AAl t 

a 代 Uaticmi 

T 卿呼 _ ，二六 ， r 二 t;: 

am wLt j Ruby 十眦 ㈣ ， 

dke td 咖如如 WaW 研 1 — ⑽ 

rtke 比吨 e - » 仏产 

RAIU — 柳甲。如 W - 咖丫讲一 m 咿奴 a 利 We 

rt q I 

r - ( <辦咖叫> -妒 《 产 i ” Wmat — bd 知⑽。 s a M 
etjcii 

，奶 er — sUrts 如 fUY AU^^ot, «r^ 

>W W 細 - 咖 ‘ 一 t 严邮。 d ㈣ l。— W Y “时 
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Leavmg twm_" 


reaf-worfd 



If s been great having you here in KailsvilleE 

WeYe sad to see you leave, but there's nothing like taking what you ve learned 
and putting it to use. You re just beginning your Rails journey, and we've put you in the 
driving seat. We re dying to hear how things go, so drop us a /iVie at the Head First Labs 
web site, www.headfirstlabs.com, and lei us know how Rails is paying off for YOU! 



